Corporate object - Create a new corporate#
This endpoint creates a draft corporate onboarding request and captures corporate, compliance, and risk data.
Validation varies by onboarding model.Field validation matrix (by model)#
A) Corporate identity & profile#
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| corporateName | Required | Required | Required | Registered legal name |
| registrationId | Required | Required | Required | Corporate registration number |
| dateOfIncorporation | Required | Required | Required | YYYY-MM-DD |
| corporateCategory | Required | Required | Required | LLC/LTD/PLC/LLP/Pty Ltd etc. |
| doingBusinessAs | Optional | Optional | Optional | Trading name (if different) |
| natureOfBusiness | Required | Required | Required | Industry code |
| taxNumber | Optional | Optional | Required | EIN must be sent for Data Only |
| website | Optional | Optional | Required | Mandatory for Data Only |
| briefBusinessDescription | Optional | Optional | Required | Mandatory for Data Only |
B) Registered address & operating address#
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| businessAddress | Required | Required | Required | Registered address |
| city | Required | Required | Required | Registered city |
| country | Required | Required | Required | Data Only: must be US |
| postalCode | Required* | Required* | Required* | Required where applicable |
| stateOrProvince | Conditionally required (see notes) | Conditionally required (see notes) | Required | Conditionally required if country = US/CA/AU; Required for Data Only |
| isSameOperatingAddress | Required | Required | Required | Boolean |
| operatingAddress | Conditionally required | Conditionally required | Conditionally required | Required if isSameOperatingAddress = false |
| operatingAddressCity | Conditionally required | Conditionally required | Conditionally required | Required if isSameOperatingAddress = false |
| operatingAddressCountry | Conditionally required | Conditionally required | Conditionally required | Required if isSameOperatingAddress = false |
| operatingAddressPostalCode | Conditionally required* | Conditionally required* | Conditionally required* | Required where applicable. |
| operatingAddressStateOrProvince | Conditionally required | Conditionally required | Conditionally required | Required if op. country = US/CA/AU |
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| contactName | Required | Required | Required | Primary contact |
| corporateEmailAddress | Required | Required | Required | Corporate email |
| phoneNumber | Required | Required | Required | Phone with country code |
| notificationEmail | Optional | Optional | Optional | Notification-only email |
| paymentQueriesContactName | Required | Required | Required | Required |
| paymentQueriesEmailAddress | Required | Required | Required | Required |
| paymentQueriesMobileNo | Required | Required | Required | Required |
D) Compliance declarations (company-level)#
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| isExistingBankAccount | Required | Required | Optional | Data Only: not required |
| bankAccountDetails | Conditionally Required | Conditionally Required | Conditionally Required | Required if isExistingBankAccount = true |
| isDispute | Required | Required | Optional | “Pending litigation/disputes” |
| disputeDetails | Conditionally Required | Conditionally Required | Conditionally Required | Required if isDispute = true |
| isBankruptcy | Required | Required | Optional | Bankruptcy/insolvency history |
| bankruptcyDetails | Conditionally Required | Conditionally Required | Conditionally Required | Required if isBankruptcy = true |
| isRegulated | Required | Required | Optional | Regulated entity flag |
| regulatedDetails | Conditionally Required | Conditionally Required | Conditionally Required | Required if isRegulated = true |
E) Payments intent, corridors, and funds#
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| anticipateReceivingPayment | Required | Required | Optional | “Who from” |
| purposeOfReceivingPayment | Required | Required | Optional | Purpose |
| anticipateSendingPayment | Required | Required | Optional | “Who to” |
| purposeOfSendingPayment | Required | Required | Optional | Purpose |
| intendPaymentCountry | Required | Required | Optional | Countries you send to |
| receivePaymentCountry | Required | Required | Optional | Countries you receive from |
| makeReceivePaymentCurrency | Required | Required | Optional | Currencies used |
| sourceOfFunds | Required | Required | Optional | Array |
| sourceOfFundsInfo | Conditionally Required | Conditionally Required | Conditionally Required | Required if sourceOfFunds includes Other |
| planToUseSokinServices | Optional | Optional | Optional | Array |
| otherPlan | Conditionally Required | Conditionally Required | Conditionally Required | Required if plan includes Other |
F) Volumes & ranges#
| Field | Non-Reliance | Semi-Reliance | Data Only | Notes |
|---|
| customerExpectedTransactionValue | Required | Required | Optional | Monthly txn value range (MoneyRange) |
| customerExpectedAmountVolume | Required | Required | Optional | Monthly txn count range (NumericRange) |
| outgoingTransactionValuePerYear | Required | Required | Optional | Annual outgoing range (MoneyRange) |
| yearsOfTrading | Optional | Optional | Optional | If you keep it: NumericRange; can be derived |
| annualRevenue | Optional | Optional | Optional | MoneyRange |
| annualFxVolumeInUsd | Optional | Optional | Optional | MoneyRange |
Modified at 2026-04-10 10:46:28
