This endpoint is being deprecated from release 2.4.0 of our api definition as per our Deprecation Policy.

Add a conversion to an open settlement. On success, returns the updated settlement entity.

The Settlement model is now deprecated and only the Balance model will be supported from 31 July 2019.

See the following Cookbook for a migration guide.

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

X-Auth-Token header string Authentication token.
id path string Settlement UUID.
conversion_id formData string Conversion UUID.
on_behalf_of formData string Contact UUID.
curl -X POST  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/settlements/{id}/add_conversion


  "id": "bffd4c70-daf6-4d16-9828-8bb4c69f8000",
  "status": "open",
  "short_reference": "20180427-FQQQSK",
  "type": "bulk",
  "conversion_ids": [
  "entries": [
      "USD": {
        "receive_amount": "500.00",
        "send_amount": "0.00"
      "GBP": {
        "receive_amount": "0.00",
        "send_amount": "354.64"
  "created_at": "2018-04-27T13:32:09+00:00",
  "updated_at": "2018-04-27T13:32:09+00:00",
  "released_at": ""
Error Codes
HTTP Status Code Description Params
400 conversion_does_not_belong_to_account Conversion cannot be added to this settlement
add_closed_conversion_failed Cannot add conversion to a settlement as it does not have any open amounts
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
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.