Set a KYB party's USD details

PATCH

/customers/v1/verifications/{companyId}/parties/{partyId}/details

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

Records an owner's country of birth and occupation code, which a KOBBLE_USD_4 wallet needs for each owner counted towards the 51% ownership rule (see POST /customers/v1/wallets). The values are held on the party's link until the owner's stakeholder exists and are copied onto it when the party is approved; when the stakeholder already exists they are written there as well. Send either field or both; a field left out is never cleared. companyId and partyId must be a party link of a company under the calling client, otherwise 404. Requires the client/write scope.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "country_of_birth": "AUS",
    "occupation_code": "261111"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/customers/v1/verifications//parties//details' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{
    "country_of_birth": "AUS",
    "occupation_code": "261111"
}'

Responses

🟢200OK

application/json

The details as now held for the party.

Bodyapplication/json

Example

{
    "party_id": "ba7116bd-f329-4d4b-adb9-b94174cc44e1",
    "country_of_birth": "string",
    "occupation_code": "string",
    "stakeholder_id": "ed78660d-fae1-4281-bda3-d18b3657bea3"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Modified at 2026-11-13 07:19:25

Email a KYB party its hosted verification link

Project the company's declared owners into KYB parties