Data Requirements

Corporate object - Create a new corporate

Endpoint
POST /corporates

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

C) Contacts & communications

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

Add Individual Associates

Endpoint
POST /corporates/associates

This endpoint adds an individual associate (natural persons, not legal entities) to an existing corporate onboarding request.

Field	Non-Reliance	Semi-Reliance	Data Only	Notes
First Name	Required	Required	Required	Required
Middle Name	Optional	Optional	Optional	Optional
Last Name	Required	Required	Required	Required
DOB	Required	Required	Required	YYYY-MM-DD Format
Email	Required	Required	Required	Required
Phone Number	Required	Required	Required	Phone Number with Country Code
Type of Associate	Required	Required	Required	Dependent on Corporate Category: LTD/LLC/PLC/PTY LTD require Director, Beneficial Owner, or UBO + Director; SOLETRADER requires Soletrader; LLP requires Partner.
Ownership Type	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Direct/Indirect
Ownership%	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Required if the associate is either a Beneficial Owner, UBO + Director, or Partner	Ownership the associate holds
PEP	Required	Required	Required	True/False
PEP Information	Required, if above yes	Required, if above yes	Required, if above yes	Required, if above True
PEP Associate	Required	Required	Required	True/False
PEP Associate Information	Required, if above yes	Required, if above yes	Required, if above yes	Required, if above True
Address Line 1	Required	Required	Required	Street
Address Line 2	Optional	Optional	Optional	Street (Optional)
City	Required	Required	Required	City
State/Province	Required for countries that have states or provinces; Otherwise Optional.	Required for countries that have states or provinces; Otherwise Optional.	Required for countries that have states or provinces; Otherwise Optional.	Mandatory for US/Canada.
Country	Required	Required	Required	Listed as 'issuingCountryCode'; Residence Country (2-character ISO country code)
Postal Code	Required (Optional for countries that do not have postcodes)	Required (Optional for countries that do not have postcodes)	Required (Optional for countries that do not have postcodes)	Alphanumeric with hyphens and spaces. E.g., UK: SW1A 1AA; Japan: 105-0001; Canada: K1A 0B1
Nationality	Required	Required	Required	2-character ISO country code
National ID Number in Country of Birth	Optional	Optional	Optional	National ID Number.
Country of Birth	Required	Required	Required	2-character ISO country code

Corporate object - Create a new corporate#

Field validation matrix (by model)#

A) Corporate identity & profile#

B) Registered address & operating address#

C) Contacts & communications#

D) Compliance declarations (company-level)#

E) Payments intent, corridors, and funds#

F) Volumes & ranges#

Add Individual Associates#