Create VASP customer information record

Creates a reusable originator/beneficiary profile for a declared VASP counterparty. A user may have multiple records per counterparty (e.g. different people at the same exchange).

Outgoing withdrawals: bind a record to the VASP counterparty at declaration time via POST /counterparty/vasp (customerInformation or vaspCustomerInformationId). Withdrawals to that counterparty then resolve the recipient PII automatically — no per-transaction lookup.

Incoming deposits: after creating a record, link it to the held deposit with POST /counterparty/vasp/customer-information/link.

The counterpartyId must reference a DECLARED VASP counterparty for the same owner and application.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Creates a reusable VASP customer-information record for a declared VASP counterparty (e.g. "Mom's Binance"). Link it to a held incoming deposit via POST /counterparty/vasp/customer-information/link.

Provide exactly one payload shape:

  • self: true — the person at the VASP is the account owner;
  • entityType NATURAL with firstName, lastName, and country;
  • entityType LEGAL with legalName and country.

Optional accountNumber (when non-empty after trim):

  • On self: true records, stored as data.accountNumber — the user's account identifier at the destination VASP, surfaced as beneficiary accountNumber on outgoing self-transfers.
  • On non-self records, stored as data.customerIdentificationNumber.

uuid

Consumer account owner ID. Send userId or businessId (at least one required on HMAC calls). If both are sent, userId is used.

uuid

Business (KYB) account owner ID. Send userId or businessId (at least one required on HMAC calls). If both are sent, userId is used.

string
required

Declared VASP counterparty id from POST /counterparty/vasp.

string

Optional human-friendly alias shown in search results.

boolean

When true, the person at the VASP is the account owner; no name fields required.

string
enum

Required when self is not true.

Allowed:
string

Optional. On self: true records, the user's account identifier at the destination VASP (stored as data.accountNumber). On non-self records, customer id at the VASP (stored as data.customerIdentificationNumber).

string

Given name (required when entityType is NATURAL).

string

Family name (required when entityType is NATURAL).

string

Country code (required when self is not true).

string

Date of birth (natural person).

string

Place of birth (natural person).

string

Registered name (required when entityType is LEGAL).

string

Legal entity identifier (legal entity).

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json