Sokin Embedded API
  1. v2025-12-01
Sokin Embedded API
  • Getting Started
    • Sokin Definitions
    • Guides
      • Authentication
      • Receiving Payments
      • FX Payments
      • Payments
      • Unfunded Payments
      • Unfunded FX Payments
  • Authentication
    • Get Token
      POST
    • Get Token on behalf of corporate
      POST
    • Schemas
      • TokenResponse
  • Corporates
    • v2025-12-01
      • Create a new Corporate
        POST
      • Request pre-signed URLs for onboarding document uploads
        POST
      • Add an individual associate to a corporate onboarding request
        POST
      • Finalise corporate onboarding submission
        POST
    • Schemas
      • FinaliseSubmissionResponse
      • PresignedUrlResponse
      • FinaliseSubmissionRequest
      • CreateCorporateResponse
      • CreateCorporateRequest
      • ApiResponse[CreateCorporateResponse]
      • AddOnboardingDocumentsRequest
  • Corporate Currency Accounts
    • v2025-12-01
      • Get Corporate Currency Accounts
      • Get Corporate Currency Account By Reference
    • Schemas
      • ErrorResponse
      • PaginationInfo
      • ErrorDetail
      • ApiResponse[GetCCAByReferenceResponse]
      • GetCCAByReferenceResponse
      • GetCCAByReferenceResponsePayInDetail
      • GetCCAsResponseItem
      • PaginatedApiResponse[GetCCAsResponseItem]
  • Beneficiaries
    • v2025-12-01
      • Get Beneficiary Fields
      • Create External Beneficiary
      • Get Beneficiary List
      • Get Beneficiary Details
      • Delete Beneficiary
    • Schemas
      • ApiResponse[BeneficiaryDetails]
      • ApiResponse[CreateExternalBeneficiaryData]
      • ApiResponse[GetBeneficiaryFieldsResponse]
      • StateOrProvince
      • PaginatedApiResponse[BeneficiaryListItem]
      • GetBeneficiaryFieldsResponse
      • ApiResponse[DeleteBeneficiaryData]
      • BeneficiaryField
      • BeneficiaryListItem
      • CreateExternalBeneficiaryData
      • CreateExternalBeneficiaryRequest
      • DeleteBeneficiaryData
      • PaginatedBeneficiaryFieldsResponse
  • Instruction Requests
    • v2025-12-01
      • Get Instruction Request By Reference
      • Create Payment Instruction Request
      • Create Fx Instruction Request
      • Create Fx Payment Instruction Request
      • Create Unfunded Payment Instruction Request
      • Create Unfunded Fx Payment Instruction Request
    • Schemas
      • ErrorResponse
      • ApiResponse[CreateInstructionRequestResponse]
      • ErrorDetail
      • ApiResponse[GetInstructionRequestResponse]
      • CreateFxPaymentInstructionRequest
      • CreateInstructionRequestResponse
      • CreatePaymentInstructionRequest
      • CreateUnfundedFxPaymentInstructionRequest
      • CreateUnfundedPaymentInstructionRequest
      • GetInstructionRequestResponse
      • CreateFXInstructionRequest
  • 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 Status
      • Update Subscription
      • Delete Subscription
      • Get Subscription By Id
      • List Notification Logs
      • Retry Notification
    • Schemas
      • ApiResponse[CreateSubscriptionResponse]
      • NotificationStatus
      • ApiResponse[NotificationLogList]
      • NotificationAttemptResponse
      • ApiResponse[UpdateSubscriptionResponse]
      • NotificationLogList
      • ErrorResponse
      • NotificationLogResponse
      • SubscriptionCreateOrUpdate
      • SubscriptionStatusUpdate
      • CreateSubscriptionResponse
      • UpdateSubscriptionResponse
      • InstructionCreated
      • ErrorDetail
      • InstructionReqeustRejected
      • InstructionProcessedWebhook
      • InstructionRejectedWebhook
      • OnboardingRequestApproved
      • OnboardingRequestRejected
      • CorporateActivated
      • CorporateDeactivated
      • CorporateCurrencyAccountFundingReceived
      • WebhookSubscription
      • WebhookNotificationLogs
  1. v2025-12-01

Add an individual associate to a corporate onboarding request

Testing Env
https://api.uat.sokin.com
Testing Env
https://api.uat.sokin.com
POST
/corporates/individual-associates
Add an individual associate (individuals, not legal entities) to a corporate onboarding request.
Associates may include Directors, Beneficial Owners, Partners, or Sole Traders, and can optionally
include ownership details and PEP (Politically Exposed Person) status.
You can:
Specify associate type, ownership type, and ownership percentage
Provide contact information and personal identification details
Indicate PEP status and include supporting information if applicable
Add residential address and nationality using valid ISO country codes
The required associate structure depends on the type of legal entity being onboarded:
LTD/LLC/PLC: Director and/or Beneficial Owner
LLP: Partner
Sole Trader: Soletrader
All associates with 25% or more ownership must be included. Those with less than 25% may be
included but are not required.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Successful Response
Body

🟠400
🟠401
🟠403
🟠404
🟠422
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.uat.sokin.com/corporates/individual-associates' \
--header 'x-api-version;' \
--header 'Content-Type: application/json' \
--data-raw ''
Response Response Example
201 - Example 1
{
    "message": "string",
    "data": {
        "associateId": "string"
    }
}
Modified at 2025-12-17 17:34:13
Previous
Request pre-signed URLs for onboarding document uploads
Next
Finalise corporate onboarding submission
Built with