Accounts

Retrieve account

Changed on

Retrieves an account by ID.

get/v1/accounts/{id}

Request

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

Path parameters

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

Unique identifier of the account.

Response

The account resource

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