Step 3: Add a parent entity (if applicable)

Use this endpoint to add a Parent Entity (legal entity) to an existing corporate onboarding request.

A Parent Entity (also referred to as a corporate associate) is a legal entity — not an individual — that forms part of the ownership or control structure of the company being onboarded.

This endpoint allows you to:

Add one Parent Entity (PE)

Add multiple associates of that Parent Entity (e.g., UBOs, Directors, Partners) within the same request

POST
/corporates/parent-entities

When this step is required

You must add a Parent Entity if:

The onboarding company has a layered ownership structure

A legal entity holds ownership or control

A corporate shareholder holds qualifying ownership (e.g., ≥25%)

If required Parent Entities are not declared, the onboarding application may not be finalised.

What you need before calling this endpoint

Ensure you have:

The corporateExternalReference returned when the primary corporate profile was created

Full legal details of the Parent Entity (name, registration ID, incorporation date, address, corporate category, role)

Details of the Parent Entity’s controlling individuals (UBOs, Directors, Partners)

Ownership percentages where applicable

The corporateExternalReference links the Parent Entity to the correct onboarding application.

Successful response

On success, the API returns:

corporateAssociateId
The unique identifier for the Parent Entity

uboIds
Identifiers for each associate submitted under that Parent Entity

These IDs are required for subsequent document uploads:

Use corporateAssociateId to upload Parent Entity company documents (where required)

Use uboIds to upload identity documents for the Parent Entity’s associates

Store these identifiers securely. They are required to complete onboarding.

What this step does — and does not do

At this stage:

The Parent Entity is linked to the onboarding application

Its associates are recorded

Ownership structure is validated

The onboarding remains in PENDING status until:

All required entities and associates are added

Required documents are uploaded

The application is finalised

Document requirements vary depending on the assigned due diligence model and ownership structure.

Next steps

After adding any required Parent Entities:

Upload required documents (if applicable)

Verify ownership thresholds and associate completeness

Finalise the onboarding request

Refer to:

Document requirements by model

Associate structure requirements

Finalise onboarding guide

Step 3: Add a parent entity (if applicable)

When this step is required#

What you need before calling this endpoint#

Successful response#

What this step does — and does not do#

Next steps#

When this step is required

What you need before calling this endpoint

Successful response

What this step does — and does not do

Next steps