Get Conversion Dates - Currencycloud API Documentation

Home > Get Conversion Dates

/v2/reference/conversion_dates

GET

Get a list of future non-trading dates for specified currency pairs. Please note that since APAC currencies do not support the 'conversion_date_preference' parameter on the conversions/create endpoint, 'default_conversion_date' returned in this response should be used and not the `first_conversion_date` or `optimize_liquidity_conversion_date`.

This endpoint will provide a list of upcoming non-trading dates, such as weekends or public holidays, for a specified currency pair. Common use cases for this endpoint will include any situations where this information wants to be provided, or for planning upcoming conversion bookings.

The API responses shown below are static. If you want to try out the API please login, or register for an API key

API parameters

Required

Name	In	Type	Description	Format
X-Auth-Token	header	string	Authentication token.
conversion_pair	query	string	Concatenated string of the two currencies converted, eg. "USDEUR".
Optional
Name	In	Type	Description	Format
start_date	query	string	Start date of conversion. ISO 8601 format YYYY-MM-DD.	date
on_behalf_of	query	string	A contact UUID for the sub-acccount you're acting on behalf of.

curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/reference/conversion_dates

Response

{
    "first_conversion_cutoff_datetime": "2021-09-20T13:20:00+00:00",
    "first_conversion_date": "2021-09-20",
    "next_day_conversion_date": "2021-09-21",
    "default_conversion_date": "2021-09-22",
    "optimize_liquidity_conversion_date": "2021-09-22",
    "invalid_conversion_dates": {
        "2021-09-25": "No trading on Saturday",
        "2021-09-26": "No trading on Sunday",
        "2021-10-02": "No trading on Saturday",
        "2021-10-03": "No trading on Sunday",
        "2021-10-09": "No trading on Saturday",
        "2021-10-10": "No trading on Sunday",
        "2021-10-11": "Columbus Day",
        "2021-10-16": "No trading on Saturday",
        "2021-10-17": "No trading on Sunday",
        "2021-10-23": "No trading on Saturday",
        "2021-10-24": "No trading on Sunday",
        "2021-10-30": "No trading on Saturday",
        "2021-10-31": "No trading on Sunday",
        "2021-11-06": "No trading on Saturday",
        "2021-11-07": "No trading on Sunday",
        "2021-11-11": "Veterans' Day",
        "2021-11-13": "No trading on Saturday",
        "2021-11-14": "No trading on Sunday",
        "2021-11-20": "No trading on Saturday",
        "2021-11-21": "No trading on Sunday",
        "2021-11-25": "Thanksgiving",
        "2021-11-27": "No trading on Saturday",
        "2021-11-28": "No trading on Sunday",
        "2021-12-04": "No trading on Saturday",
        "2021-12-05": "No trading on Sunday",
        "2021-12-11": "No trading on Saturday",
        "2021-12-12": "No trading on Sunday",
        "2021-12-18": "No trading on Saturday",
        "2021-12-19": "No trading on Sunday",
        "2021-12-25": "No trading on Saturday",
        "2021-12-26": "No trading on Sunday",
        "2021-12-27": "Christmas OBS",
        "2021-12-28": "Boxing Day OBS",
        "2022-01-01": "No trading on Saturday",
        "2022-01-02": "No trading on Sunday",
        "2022-01-03": "New Year's Day OBS",
        "2022-01-08": "No trading on Saturday",
        "2022-01-09": "No trading on Sunday",
        "2022-01-15": "No trading on Saturday",
        "2022-01-16": "No trading on Sunday",
        "2022-01-17": "Martin Luther King Jr. Day",
        "2022-01-22": "No trading on Saturday",
        "2022-01-23": "No trading on Sunday",
        "2022-01-29": "No trading on Saturday",
        "2022-01-30": "No trading on Sunday",
        "2022-02-05": "No trading on Saturday",
        "2022-02-06": "No trading on Sunday",
        "2022-02-12": "No trading on Saturday",
        "2022-02-13": "No trading on Sunday",
        "2022-02-19": "No trading on Saturday",
        "2022-02-20": "No trading on Sunday",
        "2022-02-21": "Presidents' Day",
        "2022-02-26": "No trading on Saturday",
        "2022-02-27": "No trading on Sunday",
        "2022-03-05": "No trading on Saturday",
        "2022-03-06": "No trading on Sunday",
        "2022-03-12": "No trading on Saturday",
        "2022-03-13": "No trading on Sunday",
        "2022-03-19": "No trading on Saturday",
        "2022-03-20": "No trading on Sunday",
        "2022-03-26": "No trading on Saturday",
        "2022-03-27": "No trading on Sunday",
        "2022-04-02": "No trading on Saturday",
        "2022-04-03": "No trading on Sunday",
        "2022-04-09": "No trading on Saturday",
        "2022-04-10": "No trading on Sunday",
        "2022-04-15": "Good Friday",
        "2022-04-16": "No trading on Saturday",
        "2022-04-17": "No trading on Sunday",
        "2022-04-18": "Easter Monday",
        "2022-04-23": "No trading on Saturday",
        "2022-04-24": "No trading on Sunday",
        "2022-04-30": "No trading on Saturday",
        "2022-05-01": "No trading on Sunday",
        "2022-05-02": "Early May Bank Holiday",
        "2022-05-07": "No trading on Saturday",
        "2022-05-08": "No trading on Sunday",
        "2022-05-14": "No trading on Saturday",
        "2022-05-15": "No trading on Sunday",
        "2022-05-21": "No trading on Saturday",
        "2022-05-22": "No trading on Sunday",
        "2022-05-28": "No trading on Saturday",
        "2022-05-29": "No trading on Sunday",
        "2022-05-30": "Memorial Day",
        "2022-06-02": "Late May Bank Holiday",
        "2022-06-03": "Jubilee Celebration",
        "2022-06-04": "No trading on Saturday",
        "2022-06-05": "No trading on Sunday",
        "2022-06-11": "No trading on Saturday",
        "2022-06-12": "No trading on Sunday",
        "2022-06-18": "No trading on Saturday",
        "2022-06-19": "No trading on Sunday",
        "2022-06-20": "Juneteenth National Independence Day OBS",
        "2022-06-25": "No trading on Saturday",
        "2022-06-26": "No trading on Sunday",
        "2022-07-02": "No trading on Saturday",
        "2022-07-03": "No trading on Sunday",
        "2022-07-04": "Independence Day",
        "2022-07-09": "No trading on Saturday",
        "2022-07-10": "No trading on Sunday",
        "2022-07-16": "No trading on Saturday",
        "2022-07-17": "No trading on Sunday",
        "2022-07-23": "No trading on Saturday",
        "2022-07-24": "No trading on Sunday",
        "2022-07-30": "No trading on Saturday",
        "2022-07-31": "No trading on Sunday",
        "2022-08-06": "No trading on Saturday",
        "2022-08-07": "No trading on Sunday",
        "2022-08-13": "No trading on Saturday",
        "2022-08-14": "No trading on Sunday",
        "2022-08-20": "No trading on Saturday",
        "2022-08-21": "No trading on Sunday",
        "2022-08-27": "No trading on Saturday",
        "2022-08-28": "No trading on Sunday",
        "2022-08-29": "Summer Bank Holiday",
        "2022-09-03": "No trading on Saturday",
        "2022-09-04": "No trading on Sunday",
        "2022-09-05": "Labor Day",
        "2022-09-10": "No trading on Saturday",
        "2022-09-11": "No trading on Sunday",
        "2022-09-17": "No trading on Saturday",
        "2022-09-18": "No trading on Sunday",
        "2022-09-24": "No trading on Saturday",
        "2022-09-25": "No trading on Sunday",
        "2022-10-01": "No trading on Saturday",
        "2022-10-02": "No trading on Sunday",
        "2022-10-08": "No trading on Saturday",
        "2022-10-09": "No trading on Sunday",
        "2022-10-10": "Columbus Day",
        "2022-10-15": "No trading on Saturday",
        "2022-10-16": "No trading on Sunday",
        "2022-10-22": "No trading on Saturday",
        "2022-10-23": "No trading on Sunday",
        "2022-10-29": "No trading on Saturday",
        "2022-10-30": "No trading on Sunday",
        "2022-11-05": "No trading on Saturday",
        "2022-11-06": "No trading on Sunday",
        "2022-11-11": "Veterans' Day",
        "2022-11-12": "No trading on Saturday",
        "2022-11-13": "No trading on Sunday",
        "2022-11-19": "No trading on Saturday",
        "2022-11-20": "No trading on Sunday",
        "2022-11-24": "Thanksgiving",
        "2022-11-26": "No trading on Saturday",
        "2022-11-27": "No trading on Sunday",
        "2022-12-03": "No trading on Saturday",
        "2022-12-04": "No trading on Sunday",
        "2022-12-10": "No trading on Saturday",
        "2022-12-11": "No trading on Sunday",
        "2022-12-17": "No trading on Saturday",
        "2022-12-18": "No trading on Sunday",
        "2022-12-24": "No trading on Saturday",
        "2022-12-25": "No trading on Sunday",
        "2022-12-26": "Christmas OBS",
        "2022-12-27": "Boxing Day OBS",
        "2022-12-31": "No trading on Saturday",
        "2023-01-01": "No trading on Sunday",
        "2023-01-07": "No trading on Saturday",
        "2023-01-08": "No trading on Sunday",
        "2023-01-14": "No trading on Saturday",
        "2023-01-15": "No trading on Sunday",
        "2023-01-21": "No trading on Saturday",
        "2023-01-22": "No trading on Sunday",
        "2023-01-28": "No trading on Saturday",
        "2023-01-29": "No trading on Sunday",
        "2023-02-04": "No trading on Saturday",
        "2023-02-05": "No trading on Sunday",
        "2023-02-11": "No trading on Saturday",
        "2023-02-12": "No trading on Sunday",
        "2023-02-18": "No trading on Saturday",
        "2023-02-19": "No trading on Sunday",
        "2023-02-25": "No trading on Saturday",
        "2023-02-26": "No trading on Sunday",
        "2023-03-04": "No trading on Saturday",
        "2023-03-05": "No trading on Sunday",
        "2023-03-11": "No trading on Saturday",
        "2023-03-12": "No trading on Sunday",
        "2023-03-18": "No trading on Saturday",
        "2023-03-19": "No trading on Sunday",
        "2023-03-25": "No trading on Saturday",
        "2023-03-26": "No trading on Sunday",
        "2023-04-01": "No trading on Saturday",
        "2023-04-02": "No trading on Sunday",
        "2023-04-08": "No trading on Saturday",
        "2023-04-09": "No trading on Sunday",
        "2023-04-15": "No trading on Saturday",
        "2023-04-16": "No trading on Sunday",
        "2023-04-22": "No trading on Saturday",
        "2023-04-23": "No trading on Sunday",
        "2023-04-29": "No trading on Saturday",
        "2023-04-30": "No trading on Sunday",
        "2023-05-06": "No trading on Saturday",
        "2023-05-07": "No trading on Sunday",
        "2023-05-13": "No trading on Saturday",
        "2023-05-14": "No trading on Sunday",
        "2023-05-20": "No trading on Saturday",
        "2023-05-21": "No trading on Sunday",
        "2023-05-27": "No trading on Saturday",
        "2023-05-28": "No trading on Sunday",
        "2023-06-03": "No trading on Saturday",
        "2023-06-04": "No trading on Sunday",
        "2023-06-10": "No trading on Saturday",
        "2023-06-11": "No trading on Sunday",
        "2023-06-17": "No trading on Saturday",
        "2023-06-18": "No trading on Sunday",
        "2023-06-24": "No trading on Saturday",
        "2023-06-25": "No trading on Sunday",
        "2023-07-01": "No trading on Saturday",
        "2023-07-02": "No trading on Sunday",
        "2023-07-08": "No trading on Saturday",
        "2023-07-09": "No trading on Sunday",
        "2023-07-15": "No trading on Saturday",
        "2023-07-16": "No trading on Sunday",
        "2023-07-22": "No trading on Saturday",
        "2023-07-23": "No trading on Sunday",
        "2023-07-29": "No trading on Saturday",
        "2023-07-30": "No trading on Sunday",
        "2023-08-05": "No trading on Saturday",
        "2023-08-06": "No trading on Sunday",
        "2023-08-12": "No trading on Saturday",
        "2023-08-13": "No trading on Sunday",
        "2023-08-19": "No trading on Saturday",
        "2023-08-20": "No trading on Sunday",
        "2023-08-26": "No trading on Saturday",
        "2023-08-27": "No trading on Sunday",
        "2023-09-02": "No trading on Saturday",
        "2023-09-03": "No trading on Sunday",
        "2023-09-09": "No trading on Saturday",
        "2023-09-10": "No trading on Sunday",
        "2023-09-16": "No trading on Saturday",
        "2023-09-17": "No trading on Sunday"
    }
}

Error Codes

HTTP Status	Code	Description	Params
400	conversion_pair_is_required	conversion_pair is required
	invalid_conversion_pair	The conversion pair specified was invalid
	conversion_pair_is_too_short	conversion_pair can not be shorter than 6 character(s)	`{ "minlength" => 6 }`
	conversion_pair_is_too_long	conversion_pair can not be longer than 6 character(s)	`{ "maxlength" => 6 }`
	start_date_is_too_far_in_future	Date is too far in the future (more than 1 year)	`{ "maxdate" => "2015-04-04T00:00:00Z", "period" => "1 year" }`
	start_date_is_in_invalid_format	start_date should be in ISO 8601 format	`{ "type" => "date" }`
	contact_not_found	Contact was not found for this id
	on_behalf_of_self	You cannot act on behalf of your own Contact
401	invalid_supplied_credentials	Authentication failed with the supplied credentials
429	too_many_requests	Too many requests have been made to the api. Please refer to the Developer Center for more information
500	internal_server_error	Internal server error
503	service_unavailable	Service is temporary unavailable

Was this post helpful?

Let us know if you liked the post. That’s the only way we can improve.

Yes

/v2/reference/conversion_dates

GET

API parameters

Required

Optional

Response

Error Codes

Start your borderless payments journey today