/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
NameInTypeDescriptionFormat
X-Auth-Token header string Authentication token.
conversion_pair query string Concatenated string of the two currencies converted, eg. "USDEUR".
Optional
NameInTypeDescriptionFormat
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-01T13:20:00+00:00",
    "first_conversion_date": "2021-09-01",
    "next_day_conversion_date": "2021-09-01",
    "default_conversion_date": "2021-09-02",
    "optimize_liquidity_conversion_date": "2021-09-02",
    "invalid_conversion_dates": {
        "2021-09-04": "No trading on Saturday",
        "2021-09-05": "No trading on Sunday",
        "2021-09-06": "Labor Day",
        "2021-09-11": "No trading on Saturday",
        "2021-09-12": "No trading on Sunday",
        "2021-09-18": "No trading on Saturday",
        "2021-09-19": "No trading on Sunday",
        "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"
    }
}
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
No

Start your borderless payments journey today

GET STARTED