Initiate closure of an identity's virtual account.

POST 
/identities/:identityId/close

Transitions the account ACTIVE or LIMITED -> CLOSING. The account stops accepting new attributed inflow immediately; any settlement already in flight is allowed to clear. Once balance reaches zero and funds are swept to sweep_destination, the account transitions CLOSING -> CLOSED automatically and an identity.closed webhook fires. This endpoint does not block until closure completes; it starts the process.

Request

Responses

202

Closure initiated, account now in CLOSING state.

400

Request failed validation.

401

Missing or invalid API key / signature.

404

Resource not found, or not visible to this integrator's namespace.

409

Identity is not in a state that can transition to CLOSING (e.g. already CLOSED or already CLOSING).