Close account

Close account

curl --request POST \
  --url https://api.example.com/accounts/{accountId}:close \
  --header 'Idempotency-Key: <idempotency-key>'

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

POST

accounts

{accountId}

:close

Close account

curl --request POST \
  --url https://api.example.com/accounts/{accountId}:close \
  --header 'Idempotency-Key: <idempotency-key>'

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

Idempotency-Key

string

required

Client-provided idempotency key. UUID v4 suggested, max 255 characters.

Maximum string length: 255

Pattern: \S

accountId

string<uuid>

required

Account ID

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

Account status change to CLOSED request accepted

Response for accepted asynchronous requests

correlationId

string

required

Correlation identifier for tracking the request through events

Example:

"550e8400-e29b-41d4-a716-446655440000"

Last modified on February 10, 2026

⌘I