> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.redpincompany.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.redpincompany.com/_mcp/server. # View Conversions GET https://sandbox.currenciesdirect.com/v1/customers/{customer_id}/conversions Retrieve details of all your previous conversions. This endpoint returns a paginated list of all foreign exchange (FX) conversions for a given customer, including conversion rates, amounts, booking dates, value dates, and conversion status. **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication) Reference: https://docs.redpincompany.com/api-reference/customers/api-integration/conversions/view-conversions ## Authentication - `Authorization` header (bearer token, required) — OAuth 2.0 Bearer token authentication. This API uses OAuth 2.0 Client Credentials flow. Please refer to the [Authentication](/api-guide/getting-started/authentication#oauth-20-authentication) section for detailed information on how to obtain and use your OAuth credentials. ## Servers - `https://sandbox.currenciesdirect.com` (Sandbox, default) - `https://api.redpincompany.com` (Production) ## Request ### Path parameters - `customer_id` (string, required) — Unique Customer Identifier ### Query parameters - `page` (integer, optional) — For queries that return arrays of data. Including this optional query parameter causes the set of results to be paginated by this number of pages. - `limit` (integer, optional) — For queries that return arrays of data. Adding this optional query parameter causes the set of results to be split into pages of this size. Default is 50. ## Response ### 200 Ok. Successfully requested details of a Conversion. - `fx_conversions` (list of FxConversionItem, required) — Array of Conversion objects containing details of all previous conversions. - `meta_data` (ViewConversionsResponseMetaData, required) — Container for metadata about the paginated response. ## Errors ### 401 Unauthorized Error Unauthorized - invalid authorization header - `code` (string, required) - `description` (string, required) — Human-readable error description - `type` (enum, optional) — Category or type of the error. - `VALIDATION_ERROR`: Error due to invalid input data or format - `AUTHORIZATION_ERROR`: Error related to insufficient permissions - `SYSTEM_ERROR`: Internal system or server errors - `RESOURCE_ERROR`: Error related to resource availability - `BUSINESS_ERROR`: Error related to business logic violations - `DATA_ERROR`: Error related to data inconsistencies or duplication - Allowed values: `VALIDATION_ERROR`, `AUTHORIZATION_ERROR`, `SYSTEM_ERROR`, `RESOURCE_ERROR`, `BUSINESS_ERROR`, `DATA_ERROR` - `field` (string, optional) - `details` (map from string to any, optional) — Additional details about the error - `timestamp` (datetime, optional) ### 404 Not Found Error Customer not found - `code` (string, required) - `description` (string, required) — Human-readable error description - `type` (enum, optional) — Category or type of the error. - `VALIDATION_ERROR`: Error due to invalid input data or format - `AUTHORIZATION_ERROR`: Error related to insufficient permissions - `SYSTEM_ERROR`: Internal system or server errors - `RESOURCE_ERROR`: Error related to resource availability - `BUSINESS_ERROR`: Error related to business logic violations - `DATA_ERROR`: Error related to data inconsistencies or duplication - Allowed values: `VALIDATION_ERROR`, `AUTHORIZATION_ERROR`, `SYSTEM_ERROR`, `RESOURCE_ERROR`, `BUSINESS_ERROR`, `DATA_ERROR` - `field` (string, optional) - `details` (map from string to any, optional) — Additional details about the error - `timestamp` (datetime, optional) ## Types ### FxConversionItem - `conversion_id` (string, required) — ID of this currency exchange for future reference. Use this ID to check the status of the conversion or retrieve conversion details. - `instruction_number` (string, required) — Unique client reference to identify this conversion in future. The format will be `{customerId}-{sequenceNumber}`. This instruction number can be used to track and reference the conversion in your system. - `selling_currency` (string, required) — ISO Code for the currency being sold. This is the source currency you are exchanging from. **Format:** 3-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code (e.g., GBP, USD, EUR) - `buying_currency` (string, required) — ISO Code for the currency being bought. This is the destination currency you are exchanging to. **Format:** 3-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code (e.g., GBP, USD, EUR) - `selling_amount` (double, required) — Amount of the currency being sold. This represents the source currency amount that will be exchanged. **Format:** Decimal number with up to 2 decimal places **Precision:** Maximum 2 decimal places - `buying_amount` (double, required) — Amount of the currency being bought. This represents the destination currency amount you will receive. **Format:** Decimal number with up to 2 decimal places **Precision:** Maximum 2 decimal places - `agreed_rate` (double, required) — Exchange rate agreed upon for this conversion. This rate determines how much of the buying currency will be received for each unit of the selling currency. **Calculation:** `buying_amount = selling_amount × agreed_rate` **Note:** This rate is locked in at the time of booking and will be used for the conversion execution. - `booking_datetime` (datetime, required) — Timestamp of this request/deal. This is the date and time when the conversion was booked and the exchange rate was locked in. **Format:** ISO 8601 date-time format (YYYY-MM-DDTHH:MM:SSZ) - `status` (enum, required) — Status of this conversion transaction. The status indicates the current state of the conversion. **Possible values include:** - `open` - This implies that the conversion is not executed/settled. - `closed` - Conversion has been fully settled or closed - Allowed values: `open`, `closed` - `value_date` (date, required) — This is the estimated date for the delivery of the funds into your wallet or (if making an outbound Payment) the Recipient's Bank Account. It is dependent upon a few conditions, such as: - The time of day of the request - Whether there is sufficient cleared funds in your account - The currency - The payment processing route to the bank account **Format:** ISO 8601 date format (YYYY-MM-DD) - `client_reference_id` (string, optional) — Unique reference ID that you assigned to this conversion for your own purposes. This is the optional `client_reference_id` query parameter that was provided when the conversion was requested via the [Request Conversion](/api-reference/customers/api-integration/conversions/request-conversion#request.query.client_reference_id) endpoint. ### ViewConversionsResponseMetaData Container for metadata about the paginated response. - `total_pages` (string, required) — Number of pages of available data. Returned as a string representation of an integer. - `total_records` (string, required) — Number of records of available data. Returned as a string representation of an integer. ## Examples **Response** ```json { "fx_conversions": [ { "conversion_id": "3912630", "instruction_number": "cust_123456789-000000011", "selling_currency": "GBP", "buying_currency": "EUR", "selling_amount": 9.25, "buying_amount": 43, "agreed_rate": 4.6478, "booking_datetime": "2018-10-19T10:51:13Z", "status": "open", "value_date": "2018-10-19", "client_reference_id": "42a8a4e6-05e0-4188-bd87-70a2febb5375" } ], "meta_data": { "total_pages": "2", "total_records": "98" } } ``` **SDK Code** ```shell cURL curl -X GET https://api.redpincompany.com/v1/customers/cust_123456789/conversions \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {access-token}' ``` ```python Example view conversions response import requests url = "https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions" querystring = {"page":"1","limit":"50"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Example view conversions response const url = 'https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Example view conversions response package main import ( "fmt" "net/http" "io" ) func main() { url := "https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Example view conversions response require 'uri' require 'net/http' url = URI("https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Example view conversions response import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50") .header("Authorization", "Bearer ") .asString(); ``` ```php Example view conversions response request('GET', 'https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Example view conversions response using RestSharp; var client = new RestClient("https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Example view conversions response import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/conversions?page=1&limit=50")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```