Add an associate to a corporate onboarding request

Testing Env

https://api.uat.sokin.com

POST

/corporates/associates

Add an 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

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

🟢201

application/json

Successful Response

Body

🟠400

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/corporates/associates' \
--header 'x-api-version;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corporateExternalReference": "string",
    "firstName": "string",
    "middleName": "string",
    "lastName": "string",
    "dateOfBirth": "string",
    "email": "string",
    "phoneNumber": "string",
    "associateType": "DIRECTOR",
    "ownershipType": "Direct",
    "ownership": 0,
    "pep": false,
    "pepInformation": "string",
    "pepAssociate": false,
    "pepAssociateInformation": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "state": "string",
    "issuingCountryCode": "st",
    "postalCode": "string",
    "nationality": "string",
    "nationalIdNumber": "string",
    "countryOfBirth": "string"
}'

Response Example

201 - Example 1

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

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

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

Request pre-signed URLs for onboarding document uploads