Accounts

List accounts

Changed on

Returns a paginated list of accounts.

get/v1/accounts

Request

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

Query parameters

limitinteger

Number of results per page (1-100). Defaults to 10.

cursorstring

Opaque cursor from a previous next_cursor.

account_numberstring

Filter by exact fiat account number.

account_holder_namestring

Filter by account holder name (case-insensitive phrase match).

status'pending' | 'active' | 'frozen'

Filter by account status.

account_program_idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440002

ID of the account program to list accounts for.

Response

List of accounts

has_moreboolean required
next_cursorstring nullable required
has_previousboolean required
previous_cursorstring nullable required

Example response

{
  "data": [
    {
      "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"
      }
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDA2In0",
  "previous_cursor": "eyJsYXN0X2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDA2In0"
}

Changes