Add a parent entity (corporate associate) to a Corporate

Testing Env

https://api.uat.sokin.com

POST

/corporates/parent-entities

Use this endpoint to add a parent entity — such as a corporate director, corporate beneficial owner, or corporate partner—to an onboarding request.

A parent entity (or corporate associate) is a legal entity (not an individual) that plays a role in the ownership or control structure of the company being onboarded.

Not all companies will need to add parent entities or upload company/director documents.
These steps are only required if the ownership structure makes it necessary.

With this endpoint, you can:

Submit key details of the parent entity, including name, registration ID, incorporation date, and address

Specify the parent entity role and corporate category (e.g., LTD, LLP, PLC)

Provide a list of Ultimate Beneficial Owners (UBOs) or controlling individuals who represent the corporate entity, along with their personal and ownership details

Link the parent entity to the correct onboarding application using a valid corporate_external_reference

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

IDs of the created parent entity and associated UBOs.

Body

🟠400

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/corporates/parent-entities' \
--header 'x-api-version;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corporateExternalReference": "string",
    "associateType": "Corporate Director or Corporate Beneficial Owner",
    "corporateCategory": "string",
    "companyName": "string",
    "registrationNumber": "string",
    "dateOfIncorporation": "string",
    "businessAddress": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "stateOfProvince": "string",
    "postalCode": "string",
    "country": "string",
    "ubos": [
        {
            "firstName": "string",
            "middleName": "string",
            "lastName": "string",
            "dateOfBirth": "string",
            "email": "string",
            "phoneNumber": "string",
            "ownership": 0,
            "isBeneficialOwner": false,
            "nationality": "string",
            "countryOfBirth": "string",
            "nationalIdNumber": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "city": "string",
            "state": "string",
            "postalCode": "string",
            "country": "string",
            "idIssuingCountry": "string"
        }
    ]
}'

Response Example

201 - Example 1

{
    "message": "string",
    "data": {
        "corporateAssociateId": "string",
        "uboIds": [
            "string"
        ]
    }
}

Modified at 2026-01-16 10:20:58

Add an individual associate to a Corporate

Request pre-signed URLs for Corporate onboarding document uploads