Accounts

Close account

Changed on

Closes an account

post/v1/accounts/{id}/close

Request

  • Base URL
    https://api.augustus.com
  • URL
    https://api.augustus.com/v1/accounts/{id}/close
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440001

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

Currency code (ISO 4217 or crypto).

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. For FBO accounts the label is set to the account holder’s name.

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.

metadataobject required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "currency": "USD",
  "status": "active",
  "label": "Jane Doe",
  "financial_addresses": [
    {
      "type": "aba",
      "routing_number": "110000000",
      "account_number": "000123456789",
      "account_holder_name": "Acme Sandbox Ltd.",
      "account_type": "checking"
    },
    {
      "type": "bic",
      "bic": "IRVTUS3NXXX",
      "account_number": "000123456789",
      "account_holder_name": "Acme Sandbox Ltd.",
      "local_bank_code": null,
      "account_type": "checking"
    }
  ],
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:35:00Z",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  }
}

Changes