Accounts

Close account

Closes an account

post/v1/accounts/{id}/close

Path parameters

idstring uuid required

Unique identifier of the account.

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

reason'aml_risk_fraud' | 'client_request' required

Reason for closing the account.

Response

Account closed successfully

idstring required

Unique identifier of the account.

type'account' required

Resource type discriminator.

currency'EUR' | 'GBP' | 'USD' | 'USDC' required

ISO 4217 currency code for the account.

account_type'virtual_account' | 'payment_account' | 'collateral_account' required

Type of the account.

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

Current status of the account.

asset_type'fiat' | 'crypto' required

Asset type of the account.

labelstring required

Human-readable label for the account.

created_atstring date-time required

ISO 8601 UTC timestamp when the account was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the account was last updated.

Changes

Changed in 5 of the 30 revisions of this API.259

Aug 17, 20263ed0a0aba68b4See the full diff
- ○
  removed the BTC enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ETH enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the POL enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the SOL enum value from the currency response property for the response status 200
  response-property-enum-value-removed
Jul 27, 20261d6de495a31d1See the full diff
- ▲
  the header request parameter Idempotency-Key became required
  request-parameter-became-required
Jul 13, 2026d92a4abea6c44See the full diff
- ●
  added the new ETH enum value to the currency response property for the response status 200
  response-property-enum-value-added
- ●
  added the new POL enum value to the currency response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SOL enum value to the currency response property for the response status 200
  response-property-enum-value-added
- ●
  added the new collateral_account enum value to the account_type response property for the response status 200
  response-property-enum-value-added
Jun 17, 202674deb4d45f9f114See the full diff
- ▲
  added the pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$ to the path request parameter id
  request-parameter-pattern-added
- ●
  added the new BTC enum value to the currency response property for the response status 200
  response-property-enum-value-added
- ○
  added IbanFinancialAddress SortCodeFinancialAddress AbaFinancialAddress CryptoWalletFinancialAddress to the financial_addresses/items/ response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  removed subschema #1 subschema #2 subschema #3 subschema #4 from the financial_addresses/items/ response property oneOf list for the response status 200
  response-property-one-of-removed
- ○
  the created_at response's property pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ was added for the status 200
  response-property-pattern-added
- ○
  the updated_at response's property pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ was added for the status 200
  response-property-pattern-added
Apr 30, 202634bf6e2cc30e1See the full diff
- ○
  endpoint added
  endpoint-added

Full history