Create a business customer profile+ API

Changed on Nov 3, 2026

[Available in Sandbox/Production environment] Create a business CP+ profile on our platform.

post/kyc/customer_profiles

Request

Base URL
https://api-sandbox.straitsx.com/v1
URL
https://api-sandbox.straitsx.com/v1/kyc/customer_profiles
Auth
API key in header X-XFERS-APP-API-KEY

Headers

X-XFERS-APP-API-KEYstring required

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.

X-PUBLIC-KEY-IDstring

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.

X-TIMESTAMPstring

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.

X-NONCEstring

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.

X-SIGNATUREstring

Base64-encoded digital signature of the canonical request string. Note: This header attribute is required when HTTP Request Signing is enabled for your account.

Request body

customerNamestring required

Customer's full name (50 alphanumeric with spaces) Regex: /^(?=.{1,50}$)[a-zA-Z0-9 ]+$/

customerNativeNamestring

Regex: /^\s*.{1,191}\s*$/

tradingNamestring

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.

merchantRefstring

Your own reference identifier for this customer profile. Must be within 191 characters. Regex: /^\s*.{1,191}\s*$/

registrationTypestring required

Business

registrationIdTypestring required

<code>business_reg_no<code>

registrationIdstring required

Business Registration Number of the customer. 4-35 alphanumeric chars. Regex: /\A[a-zA-Z0-9\- ]{4,35}\z/

entityLegalFormstring required

Accepted values: PRIVATE_COMPANYorPUBLIC_COMPANY

businessContactstring required

Provide the string in a valid format. Regex: ^\+?[1-9]\d{0,3}[\s\-]?$?\d{1,4}$?[\s\-]?\d{1,4}[\s\-]?\d{1,4}[\s\-]?\d{0,4}$

websitestring

Provide a valid URL. Regex: /^(https?:\/\/)?(([0-9]{1,3}(\.[0-9]{1,3}){3,5})|(([-\p{L}0-9]{1,256}\.)+[-\p{L}]{2,6}))(:[0-9]+)?([\/?].*)?$/i

countryOfIncorporationstring required

Customer's country of incorporation. 2 digit ISO country code - https://www.iban.com/country-codes List of accepted countries, Refer to Other Info > Accepted Countries

dateOfIncorporationstring required

yyyy-MM-dd format

natureOfBusinessstring required

Accepted Values: PERSONAL_INVESTMENT_COMPANIES SUPERANNUATION_FUND CRYPTO_MINING PROPRIETARY_TRADING ALGORITHM_CRYPTO_TRADERS P2P_MERCHANTS OTHER_WEB3_SERVICES_NON_VASP ACCOMMODATION_AND_FOOD_SERVICES WASTE_MANAGEMENT_AND_REMEDIATION_SERVICES AGRICULTURE_FORESTRY_FISHING_AND_HUNTING ARTS_ENTERTAINMENT_AND_RECREATION EDUCATIONAL_SERVICES GAMING HEALTHCARE_AND_SOCIAL_ASSISTANCE INFORMATION GENERAL_MANUFACTURING PROFESSIONAL_SERVICES SCIENTIFIC_AND_TECHNICAL_SERVICES RETAIL_ELECTRONICS RETAIL_FOOD_AND_BEVERAGE RETAIL_JEWELRY RETAIL_OTHERS SALE_OF_DRUGS_AND_PHARMACEUTICAL_PRODUCTS TRANSPORTATION_AND_WAREHOUSING FAMILY_OFFICE SOVEREIGN_WEALTH_FUND INVESTMENT_FUNDS CRYPTO_EXCHANGE_BROKER CRYPTO_ATM OTHER_DIGITAL_ASSET_SERVICE_PROVIDERS_VASP BANK NON_BANK_FINANCIAL_INSTITUTION MONEY_SERVICES_BUSINESS_PAYMENT_SERVICE_PROVIDERS CONSTRUCTION GENERAL_WHOLESALERS MANAGEMENT_OF_COMPANIES PRECIOUS_STONES_METALS_DEALERS CRUDE_OIL_NATURAL_GAS_DEALERS PAWN_SHOPS PUBLIC_ADMINISTRATION REAL_ESTATE_RENTAL_LEASING UTILITIES OTHERS

otherNatureOfBusinessstring

*Required field if natureOfBusiness is OTHERS Format: Free text

usOwnershipboolean required

true / false

intermediariesboolean required

true / false - Refers to this onboarding question: “Is your company owned by any intermediary companies/legal arrangement (at least 10% or more)?

monthlyTransactionVolumestring required

In USD. Accepted Values: 0_TO_100000, 100001_TO_500000, 500001_TO_1000000, 100001_TO_10000000, GT_10000000

sourceOfFundsstring[] required

Accepted Values: LOAN_FROM_PARENT_COMPANY LOAN_FROM_DIRECTORS_SHAREHOLDERS INVESTOR_FUNDS BUSINESS_LOANS BUSINESS_REVENUE CUSTOMER_FUNDS_FOR_INVESTMENT ARBITRAGE_TRADING EMPLOYMENT_INCOME BUSINESS_OWNERSHIP_INCOME PROPERTY_OWNERSHIP INVESTMENT_HOLDINGS_RETURNS GIFTS_INHERITANCE CASH_SAVINGS OTHERS

otherSourceOfFundsstring

*Required field if sourceOfFunds includes OTHERS Free text.

licensingStatusstring

Accepts: FULLY_LICENSED, EXEMPT_FROM_LICENSING, IN_PRINCIPLE_APPROVAL_GRANTED, LICENSE_APPLICATION_IN_PROGRESS, NOT_SUBJECTED_TO_LICENSING_REQUIREMENTS documents.operatingLicense field becomes mandatory if any option is selected apart from NOT_SUBJECTED_TO_LICENSING_REQUIREMENTS

purposeOfAccountstring

Declared purpose of the account. Accepts only INVESTMENT, TRADING, REMITTANCES, TREASURY MANAGEMENT, BUSINESS USAGE and OTHERS

otherPurposeOfAccountstring

Required if OTHERS is selected for purposeOfAccount field.

Response

200

Example response

{
  "data": {
    "id": "customer_profile_91689f61-ab6f-4126-af18-35a906046d72",
    "type": "customer_profile",
    "attributes": {
      "customerName": "ABC Pte Ltd",
      "tradingName": "ABC's Brand",
      "registrationType": "business",
      "registrationIdCountry": "SG",
      "registrationIdType": "business_reg_no",
      "registrationId": "20123231SA",
      "entityLegalForm": "PUBLIC_COMPANY",
      "businessContact": "0365109217",
      "countryOfIncorporation": "SG",
      "dateOfIncorporation": "1999-09-09",
      "address": {
        "street": "Northside 18th",
        "city": "Singapore",
        "postalCode": "8809",
        "state": "Singapore",
        "country": "SG"
      },
      "operatingAddress": {
        "street": "Northside 18th",
        "city": "Singapore",
        "postalCode": "8809",
        "state": "Singapore",
        "country": "SG"
      },
      "natureOfBusiness": "PERSONAL_INVESTMENT_COMPANIES",
      "usOwnership": true,
      "intermediaries": true,
      "intermediariesDocuments": [
        {
          "certificateOfIncorporation": "https://xyz.com/download-link",
          "memorandum": "https://xyz.com/download-link",
          "registerOfMembers": "https://xyz.com/download-link",
          "certificateOfIncumbency": "https://xyz.com/download-link"
        }
      ],
      "monthlyTransactionVolume": "80001_TO_100000",
      "sourceOfWealth": {
        "investorFunds": {
          "document": "https://xyz.com/download-link"
        },
        "businessLoans": {
          "document": "https://xyz.com/download-link"
        },
        "others": {
          "details": "other source of wealth",
          "document": "https://xyz.com/download-link"
        }
      },
      "sourceOfFunds": [
        "PERSONAL_SAVINGS"
      ],
      "otherSourceOfFunds": "other source of funds",
      "directors": [
        {
          "firstName": "John",
          "lastName": "Doe",
          "dateOfBirth": "1950-01-01",
          "registrationId": "A12321321",
          "registrationIdType": "passport",
          "registrationIdCountry": "SG",
          "identityDocuments": {
            "passport": "https://xyz.com/download-link"
          },
          "nationality": "SG",
          "countryOfResidence": "SG"
        }
      ],
      "beneficialOwners": [
        {
          "firstName": "John",
          "lastName": "Doe",
          "dateOfBirth": "1950-01-01",
          "registrationId": "A12321321",
          "registrationIdType": "passport",
          "registrationIdCountry": "SG",
          "identityDocuments": {
            "passport": "https://xyz.com/download-link"
          },
          "nationality": "SG",
          "countryOfResidence": "SG",
          "address": {
            "street": "Northside 18th",
            "city": "Singapore",
            "postalCode": "8809",
            "state": "Singapore",
            "country": "SG"
          },
          "proofOfAddress": "https://xyz.com/download-link"
        }
      ],
      "trader": {
        "firstName": "John",
        "lastName": "Doe",
        "dateOfBirth": "1950-01-01",
        "registrationId": "A12321321",
        "registrationIdType": "identity_card",
        "registrationIdCountry": "SG",
        "identityDocuments": {
          "idFront": "https://xys.com/download-link",
          "idBack": "https://xys.com/download-link"
        },
        "selfie": "https://xyz.com/download-link",
        "livenessSnapshot": "https://xyz.com/download-link",
        "livenessResult": true,
        "nationality": "SG",
        "countryOfResidence": "SG",
        "address": {
          "street": "Northside 18th",
          "city": "Singapore",
          "postalCode": "8809",
          "state": "Singapore",
          "country": "SG"
        },
        "proofOfAddress": "https://xyz.com/download-link"
      },
      "documents": {
        "certificateOfIncorporation": "https://xys.com/download-link",
        "memorandum": "https://xys.com/download-link",
        "registerOfDirectors": "https://xys.com/download-link",
        "registerOfMembers": "https://xys.com/download-link",
        "sanctionQuestionnaire": "https://xys.com/download-link",
        "amlQuestionnaire": "https://xys.com/download-link",
        "operatingLicense": "https://xys.com/download-link",
        "proofOfAddress": "https://xys.com/download-link"
      },
      "verificationStatus": "pending",
      "createdAt": "2025-01-16T09:52:52Z",
      "updatedAt": "2025-01-16T09:52:52Z"
    }
  }
}

Changes

Nov 3, 2026d17239d67150 Revision changes
- info
  the request property became optional

Operation history