Conversion Split History - Currencycloud API Documentation

Home > Conversion Split History

/v2/conversions/{id}/split_history

GET

Returns a JSON structure of conversion split history details.

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
X-Auth-Token	header	string	Authentication token.
id	path	string	Conversion UUID.

curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/conversions/{id}/split_history

Response

{
    "parent_conversion": null,
    "origin_conversion": null,
    "child_conversions": [
        {
            "id": "240f3764-c0c7-41e0-b0a0-a2fbd5347c00",
            "short_reference": "20191022-ZHPWXQ",
            "sell_amount": "35.51",
            "sell_currency": "GBP",
            "buy_amount": "50.00",
            "buy_currency": "USD",
            "settlement_date": "2019-10-23T15:30:00+00:00",
            "conversion_date": "2019-10-23T00:00:00+00:00",
            "status": "awaiting_funds"
        }
    ]
}

Error Codes

HTTP Status	Code	Description
400	id_is_not_valid_uuid	id should be in UUID format
	on_behalf_of_self	You cannot act on behalf of your own Contact
	contact_not_found	Contact was not found for this id
401	invalid_supplied_credentials	Authentication failed with the supplied credentials
403	permission_denied	You do not have permission 'split_conversion' to perform this operation
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 page helpful?

Yes

/v2/conversions/{id}/split_history

GET

API parameters

Required

Response

Error Codes

Start your borderless payments journey today

Cookies