1. v2025-12-01
Sokin Embedded API
  • Getting Started
    • Sokin Definitions
    • Guides
      • Authentication
      • Receiving Payments
      • FX Payments
      • Payments
      • Unfunded Payments
      • Unfunded FX Payments
      • Corporate Onboarding
        • Data Requirements
        • Step 1: Create a corporate profile
        • Step 2: Add associates
        • Step 3: Add a parent entity (if applicable)
        • Step 4: Upload company documents
        • Step 5: Upload associate documents
        • Real-time Status Updates via Webhook
        • Conditional Step: Upload Parent Entity documents (if applicable)
        • Step 6: Finalise onboarding submission
        • Uploading supporting documents using Pre-signed URLs
        • Onboarding Reference Data
        • Onboarding Models
          • Data-Only model
          • Supported Jurisdictions & National ID Requirements
  • Authentication
    • Get Token
      POST
    • Get Token on behalf of corporate
      POST
    • Schemas
      • TokenResponse
  • Corporates
    • v2025-12-01
      • Create a new Corporate
        POST
      • Add a parent entity (corporate associate) to an onboarding request
        POST
      • Add an associate to a corporate onboarding request
        POST
      • Request pre-signed URLs for onboarding document uploads
        POST
      • Request pre-signed URLs for parent entity document uploads
        POST
      • Request pre-signed URLs for associate document uploads
        POST
      • Finalise corporate onboarding submission
        POST
    • Schemas
      • NumericRange
      • ApiResponse[AddIndividualAssociateResponse]
      • ApiResponse[AddAssociateDocumentsResponse]
      • ApiResponse[AddOnboardingDocumentsResponse]
      • AddOnboardingDocumentsResponse
      • AssociateDocumentPresignedUrlResponse
      • AssociateType
      • ErrorResponse
      • MessageResponse
      • FinaliseSubmissionResponse
      • AddParentEntityRequest
      • MoneyRange
      • AddOnboardingDocumentsRequest
      • ApiResponse[CreateCorporateResponse]
      • CreateCorporateRequest
      • CreateCorporateResponse
      • FinaliseSubmissionRequest
      • PresignedUrlResponse
      • AddressTypeEnum
      • OwnershipType
      • AddAssociateDocumentsResponse
      • ErrorDetail
      • AddIndividualAssociateRequest
      • UboDetails
      • AddParentEntityResponse
      • CorporateCategories
      • AddIndividualAssociateResponse
      • CorporateAssociateType
      • AddParentEntityDocumentsRequest
      • AssociateDocumentPresignedUrlResponseItem
      • ApiResponse[AddParentEntityResponse]
      • AssociateIdentityType
      • ApiResponse[CorporateDetailResponse]
      • AddAssociateDocumentsRequest
      • CorporateDetailResponse
  • Corporate Currency Accounts
    • v2025-12-01
      • Get Corporate Currency Accounts
      • Get Corporate Currency Account By Reference
    • Schemas
      • PaginatedApiResponse[GetCCALedgerItemsResponseItem]
      • ErrorResponse
      • GetCCALedgerItemsResponseItem
      • PaginationInfo
      • ErrorDetail
      • ApiResponse[GetCCAByReferenceResponse]
      • GetCCAByReferenceResponse
      • GetCCAByReferenceResponsePayInDetail
      • GetCCAsResponseItem
      • PaginatedApiResponse[GetCCAsResponseItem]
  • Beneficiaries
    • v2025-12-01
      • Get Beneficiary Schema
      • Create Beneficiary
      • Get Beneficiary List
      • Get Beneficiary Details
      • Delete Beneficiary
      • Validate Beneficiary
      • List Financial Institutions
      • List Financial Institution Branches
    • Schemas
      • DestinationResponse
      • ErrorResponse
      • FieldType
      • PaymentMethodType
      • IdentifierType
      • AccountNumberType
      • TransactionTypeEnum
      • CompanyDetailsRequest
      • BeneficiaryType
      • RoutingCodeRequest
      • PaginatedApiResponse[FinancialInstitutionBranchReferenceResponse]
      • AccountType
      • ApiResponse[ValidateBeneficiaryResponse]
      • ApiResponse[BeneficiaryDetails]
      • ApiResponse[CreateExternalBeneficiaryData]
      • ApiResponse[DeleteBeneficiaryData]
      • ApiResponse[GetBeneficiaryFieldsResponse]
      • BeneficiaryField
      • BeneficiaryListItem
      • CreateExternalBeneficiaryData
      • CreateExternalBeneficiaryRequest
      • DeleteBeneficiaryData
      • GetBeneficiaryFieldsResponse
      • PaginatedApiResponse[BeneficiaryListItem]
      • StateOrProvince
      • AddressRequest
      • PaginationInfo
      • ValidateBeneficiaryResponse
      • PaginationInfo
      • FinancialInstitutionReferenceResponse
      • PaginatedBeneficiaryFieldsResponse
      • GetBeneficiarySchemaResponse
      • VirtualAccountDestinationRequest
      • BeneficiaryDestinationValidationResult
      • BeneficiarySchemaCondition
      • ErrorDetail
      • StateOrProvince
      • FinancialInstitutionRequest
      • BankAccountDestinationRequest
      • BeneficiaryDetails
      • CreateBeneficiaryRequest
      • ETransferDestinationRequest
      • StateOrProvince
      • BeneficiaryEntityType
      • RegionalHints
      • SchemaFieldType
      • BeneficiarySchemaField
      • ValidateBeneficiaryRequest
      • RoutingScheme
      • BeneficiaryValidationPayload
      • CompanyDetailsResponse
      • PaymentRail
      • ApiResponse[BeneficiaryResponse]
      • BankAccountCategory
      • ApiResponse[ListFinancialInstitutionsResponse]
      • ValidateBeneficiariesRequest
      • SokinInternalDestinationRequest
      • IndividualDetailsResponse
      • PageInfo
      • AddressResponse
      • BeneficiaryResponse
      • FinancialInstitutionBranchReferenceResponse
      • ListFinancialInstitutionsResponse
      • ValidateBatchBeneficiariesResponse
      • IndividualDetailsRequest
      • CurrencyCode
      • BeneficiaryStatus
      • PaginatedApiResponse[BeneficiaryResponse]
      • PaginationInfo
      • ApiResponse[ValidateBatchBeneficiariesResponse]
      • ApiResponse[GetBeneficiarySchemaResponse]
      • ApiResponse[list[FinancialInstitutionReferenceResponse]]
      • BeneficiaryValidationResultResponse
      • FieldErrorResponse
      • ValidationStatus
  • Instruction Requests
    • v2025-12-01
      • Create Payment Instruction Request
      • Create Fx Instruction Request
      • Create Fx Payment Instruction Request
      • Create Unfunded Payment Instruction Request
      • Create Unfunded Fx Payment Instruction Request
      • Get Instruction Request By Reference
    • Schemas
      • ErrorResponse
      • ApiResponse[CreateInstructionRequestResponse]
      • ErrorDetail
      • ApiResponse[GetInstructionRequestResponse]
      • CreateFXInstructionRequest
      • CreateFxPaymentInstructionRequest
      • CreateInstructionRequestResponse
      • CreatePaymentInstructionRequest
      • CreateUnfundedFxPaymentInstructionRequest
      • CreateUnfundedPaymentInstructionRequest
      • GetInstructionRequestResponse
  • Instructions
    • v2025-12-01
      • Get Instruction By Reference
    • Schemas
      • ErrorDetail
      • ErrorResponse
      • ApiResponse[GetInstructionResponse]
      • GetInstructionResponse
  • Foreign Exchange
    • v2025-12-01
      • Get Fx Rate
    • Schemas
      • ErrorResponse
      • FxRateData
      • FixedSide
      • ApiResponse[FxRateData]
      • ErrorDetail
      • FxRateRequest
  • Webhooks
    • Webhooks
    • v2025-12-01
      • Create Subscription
      • Update Subscription
      • Update Subscription Status
      • Get Subscription By Id
      • Delete Subscription
      • Retry Notification
      • List Notification Logs
    • Schemas
      • PaginatedApiResponse[NotificationLogResponse]
      • ApiResponse[CreateSubscriptionResponse]
      • NotificationStatus
      • ApiResponse[NotificationLogList]
      • NotificationAttemptResponse
      • PageInfo
      • NotificationLogList
      • ApiResponse[UpdateSubscriptionResponse]
      • ErrorResponse
      • NotificationLogResponse
      • SubscriptionCreateOrUpdate
      • PaginationInfo
      • SubscriptionStatusUpdate
      • CreateSubscriptionResponse
      • PaginationInfo
      • UpdateSubscriptionResponse
      • InstructionCreated
      • PaginationInfo
      • ErrorDetail
      • InstructionReqeustRejected
      • InstructionProcessedWebhook
      • InstructionRejectedWebhook
      • OnboardingRequestApproved
      • OnboardingRequestRejected
      • CorporateActivated
      • CorporateDeactivated
      • CorporateCurrencyAccountFundingReceived
      • WebhookSubscription
      • WebhookNotificationLogs
  1. v2025-12-01

Create a new Corporate

Testing Env
https://api.uat.sokin.com
Testing Env
https://api.uat.sokin.com
POST
/corporates
This API collects the detailed business, operational, and compliance information required to register and onboard a corporate entity.
You will be asked to submit key data about the company, such as:
Company and contact details
Business activity and regulatory status
Intended payment use and source of funds
Bank account information and dispute declarations
Associate information, based on your organization type
The required associate structure depends on the type of legal entity being onboarded:
LTD / LLC / PLC / Pty Ltd (Limited companies, including Private and Public Limited Companies)
Requires at least 1 Director and 1 Beneficial Owner (or 1 single individual who performs both roles)
Allowed associate types: Director, Beneficial Owner, Director + UBO (1 single individual who performs both roles), CDCBO.
LLP (Limited Liability Partnership)
Requires either 2 Partners, or 1 Partner and 1 Corporate Partner
Allowed associate types: Partner, Corporate Partner
Sole Trader
Requires exactly 1 Sole Trader
No additional associates are allowed

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
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 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": "string",
    "website": "string",
    "corporateCategory": "LLC",
    "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": "string",
    "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": true,
    "bankAccountDetails": "string",
    "isDispute": false,
    "disputeDetails": "string",
    "isBankruptcy": false,
    "bankruptcyDetails": "string",
    "isRegulated": false,
    "regulatedDetails": "string",
    "anticipateReceivingPayment": "string",
    "purposeOfReceivingPayment": "string",
    "anticipateSendingPayment": "string",
    "purposeOfSendingPayment": "string",
    "intendPaymentCountry": "string",
    "receivePaymentCountry": "string",
    "makeReceivePaymentCurrency": "string",
    "sourceOfFunds": [
        "string"
    ],
    "sourceOfFundsInfo": "string",
    "planToUseSokinServices": [
        "string"
    ],
    "otherPlan": "string",
    "briefBusinessDescription": "stringstringstringstringstringstringstringstringstringstring",
    "referenceId": "string"
}'
Response Response Example
201 - Example 1
{
    "message": "string",
    "data": {
        "externalReference": "string"
    }
}
Modified at 2026-04-20 12:34:21
Previous
TokenResponse
Next
Add a parent entity (corporate associate) to an onboarding request
Built with