---
updatedAt: 2026-08-12T06:48:26.000Z
agentTools:
projectIndex: https://docs.straitsx.com/llms.txt
---
# Update a business customer profile
[Available in Sandbox/Production environment] Update a business customer profile on our platform.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "base-url",
"version": "1.6.0"
},
"servers": [
{
"url": "https://api-sandbox.straitsx.com/v1"
}
],
"security": [
{}
],
"paths": {
"/kyc/customer_profiles/{customer_profile_id}": {
"patch": {
"summary": "Update a business customer profile",
"description": "[Available in Sandbox/Production environment] Update a business customer profile on our platform.",
"operationId": "update-a-business-customer-profile",
"parameters": [
{
"name": "customer_profile_id",
"in": "path",
"description": "Customer Profile ID is retrieved from the response id of Create Customer Profile API
Regex: `/^\\s*.{1,191}\\s*$/`",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "X-XFERS-APP-API-KEY",
"in": "header",
"description": "You can retrieve this from your Dashboard Developer Tools.
Note: The `X-XFERS-APP-API-KEY` is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "X-PUBLIC-KEY-ID",
"in": "header",
"description": "The Key ID, can be retrieved from your StraitsX Dashboard.
Note: This header attribute is required when HTTP Request Signing is enabled for your account.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "X-TIMESTAMP",
"in": "header",
"description": "Current Unix epoch time in seconds. Must be within ±300 seconds of server time.
Note: This header attribute is required when HTTP Request Signing is enabled for your account.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "X-NONCE",
"in": "header",
"description": "A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.
Regex: `/\\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\z/i`
Note: This header attribute is required when HTTP Request Signing is enabled for your account.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "X-SIGNATURE",
"in": "header",
"description": "Base64-encoded digital signature of the canonical request string.
Note: This header attribute is required when HTTP Request Signing is enabled for your account.",
"required": false,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"customerName": {
"type": "string",
"description": "Customer's full name (50 alphanumeric with spaces)
Regex: `/^(?=.{1,50}$)[a-zA-Z0-9 ]+$/`"
},
"tradingName": {
"type": "string",
"description": "The brand or trading name of the business, if different from the legal entity name (`customerName`).
Length: 1 - 50 characters.
Regex: `/\\A[\\x20-\\x3B\\x3D\\x3F-\\x7E]{1,50}\\z/`
Note: If provided, this name will be used for PayNow registration instead of the legal entity name. If absent, the PayNow registration falls back to `customerName`."
},
"registrationIdCountry": {
"type": "string",
"description": "Customer's registration ID country (2 digit ISO country code) from https://www.iban.com/country-codes
Regex: `/^[A-Z]{2}$/`"
},
"registrationIdType": {
"type": "string",
"description": "Customer's registration ID type
Only accepts `business_reg_no`"
},
"registrationId": {
"type": "string",
"description": "UEN of company (4 to 35 alphanumeric)
Regex: `%r{\\A[a-zA-Z0-9/\\-?:().,'+ ]{4,35}\\z}`"
},
"placeOfBiz": {
"type": "string",
"description": "Customer's principal place of business if it is different from registered address. Otherwise, provide registered address.
Regex: `/^\\s*.{1,255}\\s*$/`"
},
"placeOfBizCountry": {
"type": "string",
"description": "Customer's principal place of business country (2 digit ISO country code) from https://www.iban.com/country-codes
Regex: `/^[A-Z]{2}$/`"
},
"countryOfIncorporation": {
"type": "string",
"description": "Customer's country of incorporation (2 digit ISO country code) from https://www.iban.com/country-codes
Regex: `/^[A-Z]{2}$/`"
},
"dateOfIncorporation": {
"type": "string",
"description": "Date must be in 'YYYY-MM-DD' format
Regex: `/^\\d{4}-\\d{2}-\\d{2}$/`",
"format": "date"
},
"address": {
"type": "object",
"description": "Customer's registered address
Required field if CP is a Indonesian profile",
"properties": {
"street": {
"type": "string",
"description": "Regex: `/^(?=.{1,180}$)[a-zA-Z0-9\\-?:().,' +]+$/`"
},
"city": {
"type": "string",
"description": "Regex: `/^(?=.{1,20}$)[a-zA-Z0-9\\-?:().,' +]+$/`"
},
"postalCode": {
"type": "string",
"description": "Regex: `/^[A-Za-z0-9\\- ]{2,20}$/`"
},
"state": {
"type": "string",
"description": "Regex: `/^(?=.{1,15}$)[a-zA-Z0-9\\-?:().,' +]+$/`"
},
"country": {
"type": "string",
"description": "Must be an alpha-2 country code. Please refer to the following document for the accepted values: https://www.iban.com/country-codes
Regex: `/^[A-Z]{2}$/`"
}
}
}
}
},
"examples": {
"Sample Request": {
"summary": "Sample Request",
"value": {
"customerName": "Xfers Pte. Ltd.",
"tradingName": "Xfers & Co.",
"registrationType": "business",
"registrationId": "201411660R",
"registrationIdType": "business_reg_no",
"countryOfIncorporation": "SG",
"dateOfIncorporation": "2014-06-05",
"registrationIdCountry": "SG",
"placeOfBiz": "100 Industry Drive, Singapore 123456",
"placeOfBizCountry": "SG",
"address": {
"street": "100 Industry Drive, #01-01",
"city": "Singapore",
"postalCode": "123456",
"state": "Singapore",
"country": "SG"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"data\": {\n \"id\": \"customer_profile_8bcef957-74a5-4c07-bcaa-0b377c02ca13\",\n \"type\": \"customer_profile\",\n \"attributes\": {\n \"customerName\": \"Xfers Pte. Ltd.\",\n \"tradingName\": \"Xfers & Co.\",\n \"registrationType\": \"business\",\n \"registrationIdType\": \"business_reg_no\",\n \"registrationIdCountry\": \"SG\",\n \"registrationId\": \"201411660R\",\n \"address\": {\n \"street\": \"10 Albert Street\",\n \"city\": \"Singapore\",\n \"postalCode\": \"000000\",\n \"state\": \"Singapore\",\n \"country\": \"SG\"\n },\n \"placeOfBiz\": \"10 Albert Street, 000000 Singapore\",\n \"placeOfBizCountry\": \"SG\",\n \"countryOfIncorporation\": \"SG\",\n \"dateOfIncorporation\": \"2020-11-14T00:00:00.000Z\",\n \"verificationStatus\": \"verified\"\n }\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "customer_profile_8bcef957-74a5-4c07-bcaa-0b377c02ca13",
"description": "Unique customer profile ID."
},
"type": {
"type": "string",
"example": "customer_profile",
"description": "Request type."
},
"attributes": {
"type": "object",
"properties": {
"customerName": {
"type": "string",
"example": "Xfers Pte. Ltd.",
"description": "Customer's full name."
},
"tradingName": {
"type": "string",
"example": "Xfers & Co.",
"description": "The brand or trading name of the business, if different from the legal entity name (`customerName`)."
},
"registrationType": {
"type": "string",
"example": "business",
"description": "Customer's registration type."
},
"registrationIdType": {
"type": "string",
"example": "business_reg_no",
"description": "Customer's registration ID type."
},
"registrationIdCountry": {
"type": "string",
"example": "SG",
"description": "The country that issues the ID."
},
"registrationId": {
"type": "string",
"example": "201411660R",
"description": "UEN of company."
},
"address": {
"type": "object",
"properties": {
"street": {
"type": "string",
"example": "10 Albert Street",
"description": "Street address."
},
"city": {
"type": "string",
"example": "Singapore",
"description": "City name."
},
"postalCode": {
"type": "string",
"example": "000000",
"description": "Postal or ZIP code."
},
"state": {
"type": "string",
"example": "Singapore",
"description": "State or region."
},
"country": {
"type": "string",
"example": "SG",
"description": "Country code."
}
},
"description": "Customer's operating address."
},
"placeOfBiz": {
"type": "string",
"example": "10 Albert Street, 000000 Singapore",
"description": "Customer's principal place of business if it is different from registered address."
},
"placeOfBizCountry": {
"type": "string",
"example": "SG",
"description": "Customer's principal place of business country."
},
"countryOfIncorporation": {
"type": "string",
"example": "SG",
"description": "This is country that incorporates the business."
},
"dateOfIncorporation": {
"type": "string",
"example": "2020-11-14T00:00:00.000Z",
"description": "Company's date of incorporation."
},
"verificationStatus": {
"type": "string",
"example": "verified",
"description": "Customer profile's verification status."
}
}
}
}
}
}
}
}
}
}
},
"deprecated": false,
"x-readme": {
"code-samples": [
{
"code": "{\n \"customerName\": \"Acme Fintech Pte Ltd\",\n \"registrationType\": \"business\", \n \"registrationId\": \"201411660R\", \n \"registrationIdType\": \"business_reg_no\", \n \"countryOfIncorporation\": \"SG\", \n \"dateOfIncorporation\": \"2014-06-05\", \n \"registrationIdCountry\": \"SG\", \n \"placeOfBiz\": \"100 Industry Drive, Singapore 123456\", \n \"placeOfBizCountry\": \"SG\", \n \"address\": {\n \"street\": \"100 Industry Drive, #01-01\",\n \"city\": \"Singapore\",\n \"postalCode\": \"123456\",\n \"state\": \"Singapore\",\n \"country\": \"SG\" \n }\n}",
"language": "json",
"name": ""
}
],
"samples-languages": [
"json"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```