Project the company's declared owners into KYB parties

Optional (on request). Applies only if this feature is enabled for your client.

For a KOBBLE_KYB_2 company whose owners the verification partner cannot discover from a registry (for example a UAE company), declare them yourself and have Kobble verify each one. Declare the owners as stakeholders on the enduser company (POST /customers/v1/endusers/{id}/stakeholders, or nested at enduser creation) with at least one of the roles DIRECTOR, UBO or SHAREHOLDER, then call this endpoint. Each ACTIVE such stakeholder becomes a type: KYC / subject_type: EXTERNAL_PARTY party verification linked to the company with source CUSTOMER and source_ref = the stakeholder id, appears in the company's links_from[], gates the KYB aggregate like a partner-discovered party, and can be given its hosted link with GET /customers/v1/verifications/{party_id}/session-token or emailed it with POST /customers/v1/verifications/{companyId}/parties/{partyId}/invite.

Idempotent by stakeholder: calling again adds parties for newly declared stakeholders, leaves existing ones untouched, and cancels and unlinks the party of a withdrawn stakeholder as long as nobody has started it (a started one is kept). A no-op when the company already has partner-discovered (PARTNER) parties, and closed (REJECTED / CANCELLED) companies gain no parties. Should the partner later deliver registry owners for a company with declared owners, both sets are kept and the company is flagged reason_code DECLARED_OWNERS_REVIEW for a Kobble officer, without a status change.

Returns the company's refreshed links_from[]. Requires the client/write scope. Owner-scoped.

Responses

🟢200OK

application/json

The company's refreshed links_from[].

Bodyapplication/json

Example

{
    "party_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "roles": [
        "DIRECTOR",
        "UBO"
    ],
    "ownership_percent": "51",
    "required": true,
    "display_name": "Fatima Al Mansoori",
    "invited_email": null,
    "invited_at": null,
    "invite_count": 0,
    "source": "CUSTOMER",
    "source_ref": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
    "party": {
        "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
        "type": "KYC",
        "status": "NOT_STARTED"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Project the company's declared owners into KYB parties

Request

Request Code Samples

Responses