> 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. # Update Third-Party Customer PATCH https://sandbox.currenciesdirect.com/v1/customers/{customer_id}/third-parties/{client_customer_ref} Content-Type: application/json Perform comprehensive updates to existing third-party customer profiles using their unique reference identifier. This endpoint empowers partners to modify third-party customer records spanning personal information, contact details, address information, employment data, financial particulars, and property details. **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication) Reference: https://docs.redpincompany.com/api-reference/customers/api-integration/third-parties/update-third-party-customer ## 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 identifier of the partner platform updating the third-party customer - `client_customer_ref` (string, required) — Partner's internal reference/ID for this customer. This is the customer reference that was provided during customer creation via [Create Partner Customer](/api-reference/customers/api-integration/third-parties/create-third-party-customer). ### Body (application/json) This endpoint expects an UpdateThirdPartyCustomerRequest. - `first_name` (string, optional) — Third party customer's first name for personal identification and account management - `last_name` (string, optional) — Third party customer's last name for personal identification and account management - `email` (string, optional) — Third party customer's primary email address for communication and account notifications - `mobile_phone` (string, optional) — Third party customer's primary contact phone number with international country code in E.164 international format (e.g., +14155552671) - `country` (string, optional) — ISO 3166-1 alpha-3 country code representing the third party customer's legal nationality or citizenship status. See [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) for the complete list of country codes. - `currency` (string, optional) — 3-letter ISO currency code for the third party customer's preferred currency. See [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) for the complete list of currency codes. - `date_of_birth` (string, optional) — Third party customer's date of birth in [ISO 8601 format] (https://en.wikipedia.org/wiki/ISO_8601) - `address` (address, optional) - `occupation` (string, optional) — Third party customer's professional occupation. - `employer_name` (string, optional) — Name of the third party customer's current employer - `income_range` (IncomeRange, optional) — Third party customer's income range in the given currency ## Response ### 200 Third-party customer updated successfully - `client_customer_ref` (string, required) — Partner's internal reference/ID for this customer. - `status` (enum, required) — Status of the third party customer. - `APPROVED`: Compliance check has passed successfully. - `REJECTED`: Compliance check has failed due to validation or regulatory issues. - `PENDING`: Compliance check is still in progress. - Allowed values: `APPROVED`, `REJECTED`, `PENDING` ## Errors ### 400 Bad Request Error Bad request - invalid or missing parameters - `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 Third-party 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) ### 422 Unprocessable Entity Error Customer is not eligible for the selected country - `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) ### 500 Internal Server Error Internal server error - `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 ### address - `address_line` (string, required) — Full street address of the customer, including apartment or unit number if applicable. Example: "123 Main St, Apt 4B" - `city` (string, required) — City or town of the customer's residence. Example: "New York" - `state` (string, required) — State, province, or region associated with the address. This field is required for countries that use regional subdivisions. Example: "NY" - `post_code` (string, required) — ZIP code, postal code, or equivalent regional code used for mail delivery. Example: "10001" - `country` (string, required) — 3-letter [ISO 3166-1] (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) country code (e.g., USA, GBR, IND) representing the country of residence. Example: "USA" ### IncomeRange Third party customer's income range in the given currency - `currency` (string, required) — 3-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code for the income range. - `min_value` (double, required) — Minimum value of the income range - `max_value` (double, required) — Maximum value of the income range ## Examples **Request** ```json { "first_name": "Sarah", "last_name": "Johnson", "email": "sarah.johnson@example.com", "mobile_phone": "+1 10055006644", "country": "US", "currency": "USD", "date_of_birth": "1985-03-15", "address": { "address_line": "123 Main St, Apt 4B", "city": "New York", "state": "NY", "post_code": "10001", "country": "USA" }, "occupation": "Software Engineer", "employer_name": "Google", "income_range": { "currency": "GBP", "min_value": 10000, "max_value": 20000 } } ``` **Response** ```json { "client_customer_ref": "SKYLINE-CLIENT-001", "status": "PENDING" } ``` **SDK Code** ```python Complete Customer Update import requests url = "https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001" payload = { "first_name": "Sarah", "last_name": "Johnson", "email": "sarah.johnson@example.com", "mobile_phone": "+1 10055006644", "country": "US", "currency": "USD", "date_of_birth": "1985-03-15", "address": { "address_line": "123 Main St, Apt 4B", "city": "New York", "state": "NY", "post_code": "10001", "country": "USA" }, "occupation": "Software Engineer", "employer_name": "Google", "income_range": { "currency": "GBP", "min_value": 10000, "max_value": 20000 } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Complete Customer Update const url = 'https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"first_name":"Sarah","last_name":"Johnson","email":"sarah.johnson@example.com","mobile_phone":"+1 10055006644","country":"US","currency":"USD","date_of_birth":"1985-03-15","address":{"address_line":"123 Main St, Apt 4B","city":"New York","state":"NY","post_code":"10001","country":"USA"},"occupation":"Software Engineer","employer_name":"Google","income_range":{"currency":"GBP","min_value":10000,"max_value":20000}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Complete Customer Update package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001" payload := strings.NewReader("{\n \"first_name\": \"Sarah\",\n \"last_name\": \"Johnson\",\n \"email\": \"sarah.johnson@example.com\",\n \"mobile_phone\": \"+1 10055006644\",\n \"country\": \"US\",\n \"currency\": \"USD\",\n \"date_of_birth\": \"1985-03-15\",\n \"address\": {\n \"address_line\": \"123 Main St, Apt 4B\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"post_code\": \"10001\",\n \"country\": \"USA\"\n },\n \"occupation\": \"Software Engineer\",\n \"employer_name\": \"Google\",\n \"income_range\": {\n \"currency\": \"GBP\",\n \"min_value\": 10000,\n \"max_value\": 20000\n }\n}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Complete Customer Update require 'uri' require 'net/http' url = URI("https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"first_name\": \"Sarah\",\n \"last_name\": \"Johnson\",\n \"email\": \"sarah.johnson@example.com\",\n \"mobile_phone\": \"+1 10055006644\",\n \"country\": \"US\",\n \"currency\": \"USD\",\n \"date_of_birth\": \"1985-03-15\",\n \"address\": {\n \"address_line\": \"123 Main St, Apt 4B\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"post_code\": \"10001\",\n \"country\": \"USA\"\n },\n \"occupation\": \"Software Engineer\",\n \"employer_name\": \"Google\",\n \"income_range\": {\n \"currency\": \"GBP\",\n \"min_value\": 10000,\n \"max_value\": 20000\n }\n}" response = http.request(request) puts response.read_body ``` ```java Complete Customer Update import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"first_name\": \"Sarah\",\n \"last_name\": \"Johnson\",\n \"email\": \"sarah.johnson@example.com\",\n \"mobile_phone\": \"+1 10055006644\",\n \"country\": \"US\",\n \"currency\": \"USD\",\n \"date_of_birth\": \"1985-03-15\",\n \"address\": {\n \"address_line\": \"123 Main St, Apt 4B\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"post_code\": \"10001\",\n \"country\": \"USA\"\n },\n \"occupation\": \"Software Engineer\",\n \"employer_name\": \"Google\",\n \"income_range\": {\n \"currency\": \"GBP\",\n \"min_value\": 10000,\n \"max_value\": 20000\n }\n}") .asString(); ``` ```php Complete Customer Update request('PATCH', 'https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001', [ 'body' => '{ "first_name": "Sarah", "last_name": "Johnson", "email": "sarah.johnson@example.com", "mobile_phone": "+1 10055006644", "country": "US", "currency": "USD", "date_of_birth": "1985-03-15", "address": { "address_line": "123 Main St, Apt 4B", "city": "New York", "state": "NY", "post_code": "10001", "country": "USA" }, "occupation": "Software Engineer", "employer_name": "Google", "income_range": { "currency": "GBP", "min_value": 10000, "max_value": 20000 } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Complete Customer Update using RestSharp; var client = new RestClient("https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001"); var request = new RestRequest(Method.PATCH); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"first_name\": \"Sarah\",\n \"last_name\": \"Johnson\",\n \"email\": \"sarah.johnson@example.com\",\n \"mobile_phone\": \"+1 10055006644\",\n \"country\": \"US\",\n \"currency\": \"USD\",\n \"date_of_birth\": \"1985-03-15\",\n \"address\": {\n \"address_line\": \"123 Main St, Apt 4B\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"post_code\": \"10001\",\n \"country\": \"USA\"\n },\n \"occupation\": \"Software Engineer\",\n \"employer_name\": \"Google\",\n \"income_range\": {\n \"currency\": \"GBP\",\n \"min_value\": 10000,\n \"max_value\": 20000\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Complete Customer Update import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "first_name": "Sarah", "last_name": "Johnson", "email": "sarah.johnson@example.com", "mobile_phone": "+1 10055006644", "country": "US", "currency": "USD", "date_of_birth": "1985-03-15", "address": [ "address_line": "123 Main St, Apt 4B", "city": "New York", "state": "NY", "post_code": "10001", "country": "USA" ], "occupation": "Software Engineer", "employer_name": "Google", "income_range": [ "currency": "GBP", "min_value": 10000, "max_value": 20000 ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://sandbox.currenciesdirect.com/v1/customers/020123456789/third-parties/SKYLINE-CLIENT-001")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data 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() ```