Axiym

Start Client Onboarding

Creates and immediately submits a client onboarding case for compliance review. Document intake is owned by Axiym's compliance KYB flow. The client is visible in GET /clients after approval; track the case with GET /onboardings/{clientId}.

View MarkdownView complete reference

Authorization

Default
AuthorizationBearer <token>

In: header

Header Parameters

X-Request-Id?string

Client-generated unique id for this request (UUID recommended), used for end-to-end tracing. Echoed back in the X-Request-Id response header and recorded in Axiym logs — quote it when contacting support. If omitted, Axiym generates one.

Formatuuid
Idempotency-Key?string

Unique client-generated key to safely retry a funds-moving request (e.g. a UUID, but any unique string works). Repeating a request with the same key returns the original result instead of creating a duplicate.

Lengthlength <= 255

Request Body

application/json

legalEntityName*string

Official name of the company

incorporationDate*string

Date legal entity was established

Formatdate
registrationDate*string

Date when the company registered / joined your network

Formatdate
legalAddress*Address

Legal Address

currency*Currency

Currency code — ISO 4217 fiat (e.g. USD, EUR) or a supported stablecoin (USDT, USDC).

partnerClientId?string

Unique identifier from the partner side to maintain data mapping and ensure onboarding uniqueness.

disbursementAccount?DisbursementAccount

Payment Network bank account that receives funding disbursements for this client (the funding destination).

paymentRails?string

Payment Rail Code

Response Body

application/json

application/json

application/json

application/json

application/json

application/json