Close account

Closes an account

POST /v1/accounts/{id}/close

JavaScript

JavaScript

import Augustus from '@augustusbank/typescript-sdk';

const client = new Augustus({
  apiKey: process.env['AUGUSTUS_API_KEY'], // This is the default and can be omitted
});

const response = await client.accounts.close('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
  reason: 'aml_risk_fraud',
});

console.log(response.id);

200

{
  "id": "<string>",
  "label": "<string>",
  "financial_addresses": [
    {
      "iban": "<string>",
      "account_holder_name": "<string>",
      "bic": "<string>"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer token for authentication with Augustus Banking API

Headers

Idempotency-Key · string

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.

Path Parameters

id · string<uuid> · required

Unique identifier of the account.

Body

application/json

Close account parameters

reason · enum<string> · required

Reason for closing the account.

Available options: aml_risk_fraud, client_request

Response

200 - application/json

Account closed successfully

id · string · required

Unique identifier of the account.

type · enum<string> · required

Resource type discriminator.

Available options: account

currency · enum<string> · required

ISO 4217 currency code for the account.

Available options: EUR, GBP, USD, USDC

account_type · enum<string> · required

Type of the account.

Available options: virtual_account, payment_account

status · enum<string> · required

Current status of the account.

Available options: pending, active, frozen, closed

asset_type · enum<string> · required

Asset type of the account.

Available options: fiat, crypto

label · string · required

Human-readable label for the account.

financial_addresses · object[] · required

Payment identifiers (e.g. IBAN, account number, wallet address) through which this account can send or receive funds.

Option 1

Option 2

Option 3

Option 4

Show child attributes

created_at · string<date-time> · required

ISO 8601 UTC timestamp when the account was created.

updated_at · string<date-time> · required

ISO 8601 UTC timestamp when the account was last updated.