Create a new Corporate

Testing Env

https://api.uat.sokin.com

POST

/corporates

Creates a Corporate and returns the generated external reference.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

External reference of the created Corporate entity.

Body

🟠400Unprocessable Entity

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/corporates' \
--header 'x-api-version;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corporateName": "Acme Technologies Ltd",
    "registrationId": "12345678",
    "dateOfIncorporation": "2020-01-15",
    "doingBusinessAs": "string",
    "natureOfBusiness": "62020",
    "taxNumber": "GB123456789",
    "website": "https://www.acme-tech.com",
    "corporateCategory": "LTD",
    "customerExpectedTransactionValue": {
        "currency": "USD",
        "max": 150000,
        "min": 1
    },
    "customerExpectedAmountVolume": {
        "max": 2,
        "min": 1
    },
    "outgoingTransactionValuePerYear": {
        "currency": "USD",
        "max": 150000,
        "min": 1
    },
    "yearsOfTrading": {
        "max": 2,
        "min": 1
    },
    "annualRevenue": {
        "currency": "USD",
        "max": 150000,
        "min": 1
    },
    "annualFxVolumeInUsd": {
        "currency": "USD",
        "max": 150000,
        "min": 1
    },
    "businessAddress": "123 Business Street",
    "country": "GB",
    "postalCode": "SW1A 1AA",
    "city": "London",
    "stateOrProvince": "string",
    "isSameOperatingAddress": true,
    "operatingAddress": "string",
    "operatingAddressCountry": "string",
    "operatingAddressPostalCode": "string",
    "operatingAddressCity": "string",
    "operatingAddressStateOrProvince": "string",
    "contactName": "John Smith",
    "corporateEmailAddress": "contact@acme-tech.com",
    "phoneNumber": "+441234567890",
    "notificationEmail": "string",
    "paymentQueriesContactName": "Jane Doe",
    "paymentQueriesEmailAddress": "payments@acme-tech.com",
    "paymentQueriesMobileNo": "+441234567891",
    "isExistingBankAccount": false,
    "bankAccountDetails": "string",
    "isDispute": false,
    "disputeDetails": "string",
    "isBankruptcy": false,
    "bankruptcyDetails": "string",
    "isRegulated": false,
    "regulatedDetails": "string",
    "anticipateReceivingPayment": "Clients/Customers, Vendors/Partners",
    "purposeOfReceivingPayment": "Sales revenue from customers",
    "anticipateSendingPayment": "Suppliers/Vendors/Partners, Employees",
    "purposeOfSendingPayment": "Supplier payments and payroll",
    "intendPaymentCountry": "GB, US, DE",
    "receivePaymentCountry": "GB, US, FR",
    "makeReceivePaymentCurrency": "GBP, USD, EUR",
    "sourceOfFunds": [
        "Inter-company payments",
        "Income from ongoing operations"
    ],
    "sourceOfFundsInfo": "Revenue from software licensing",
    "planToUseSokinServices": [
        "string"
    ],
    "otherPlan": "string",
    "briefBusinessDescription": "stringstringstringstringstringstringstringstringstringstring",
    "referenceId": "string"
}'

Response Example

201 - Example 1

{
    "message": "string",
    "data": {
        "externalReference": "string"
    }
}

Modified at 2026-02-27 15:27:23

TokenResponse

Add a parent entity (corporate associate) to an onboarding request