Added

New "identifications" field on the account identity schema

Broker API

The account identity object now documents identifications, an array of identification documents, along with a new Identification schema.

  • type is required on each entry (for example passport, national_id, or LEI in uppercase).
  • number and issued_country are write-only and required on write; an LEI number must pass ISO 17442 check digits or the request fails with 422.
  • issued_date is write-only and cannot be later than today (UTC); expiry_date is write-only, must be later than today (UTC), and not before issued_date.
  • On update, the submitted list replaces every stored identification except the tax ID entry.
  • Responses include identifications only for natural persons and return type only; the tax ID appears as an entry.
  • tax_id_type now notes that LEI, in any case, fails with 422 — send the LEI in identifications and the national tax ID in tax_id.

Affected Endpoints

  • POST /v1/accounts
  • GET /v1/accounts
  • GET /v1/accounts/{account_id}
  • PATCH /v1/accounts/{account_id}