v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-044359269.1 KB

Account Holders

Create account holder

Creates a new account holder and starts asynchronous processing.

post/v1/account_holders

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

account_program_idstring uuid required

ID of the account program to create the account holder under.

holder_type'natural_person' | 'business' required

Type of the account holder.

Response

Account holder created successfully

idstring required

Unique identifier of the account holder.

type'account_holder' required

Resource type discriminator.

holder_type'natural_person' | 'business' required

Type of the account holder.

status'pending' | 'active' | 'closed' required

Current account holder status.

created_atstring date-time required

ISO 8601 UTC timestamp when the account holder was created.