Sign in
Simulations

Close an operating account

Closes an operating (DDA) account. The account must be drained via the drain endpoint first. This endpoint is unavailable in live production.

post/v1/simulations/accounts/{id}/close

Path parameters

idstring uuid required

ID of the account whose lifecycle is being simulated.

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

The account close simulation acknowledgement

type'account_simulation' required

Resource type discriminator.

successboolean required

Whether the simulation submission was successful.

account_idstring uuid required

Account whose lifecycle is being simulated.

event'create' | 'freeze' | 'unfreeze' | 'close' | 'drain' required

Account lifecycle event submitted to the sandbox.

payout_idstring uuid nullable required

Payout created by a drain event. Feed to POST /v1/simulations/payouts/{id}/send to settle. null for non-drain events.

Changes

Changed in 1 of the 38 revisions of this API.1