---
title: "List all accounts"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List all accounts

`GET /v1/accounts`

## Request

- Base URL: `https://api.tesser.xyz`
- URL: `https://api.tesser.xyz/v1/accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tesser/apis/tesser-api/docs/v1/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all accounts for your workspace with optional filtering and pagination.

## Query parameters

- `type` 'fiat_bank' | 'stablecoin_ethereum' | 'stablecoin_solana' | 'stablecoin_stellar' | 'ledger' | 'generic'
- `tenant_id` string, uuid
- `counterparty_id` string, uuid
- `entity_type` 'sub_org' | 'counterparty' | 'tenant'
- `search` string
- `is_managed` 'true' | 'false'
- `include_secure` boolean
- `compliance_accepted` boolean
- `page` integer
- `limit` integer

## Response `200`

Accounts retrieved successfully

- AccountListResponse
  - `data` AccountData[], required
    - `id` string, required: Unique identifier for the account
    - `workspace_id` string, required: Workspace ID the account belongs to
    - `tenant_id` string, nullable: Tenant ID (if account belongs to a tenant)
    - `counterparty_id` string, nullable: Counterparty ID (if account belongs to a counterparty)
    - `type` string, required: Account type
    - `name` string, required: Account name
    - `bank_name` string, nullable: Bank name (only for fiat_bank accounts)
    - `bank_code_type` string, nullable: Bank code type (only for fiat_bank accounts)
    - `bank_identifier_code` string, nullable: Bank identifier code (only for fiat_bank accounts)
    - `bank_swift_code` string, nullable: SWIFT code (only for fiat_bank accounts)
    - `bank_account_number` string, nullable: Bank account number (masked, only with include_secure=true)
    - `crypto_wallet_address` string, nullable: Crypto wallet address (only for wallet accounts)
    - `is_managed` boolean, nullable: Is managed wallet (only for wallet accounts)
    - `generic_account_number` string, nullable: Account identifier (only for generic accounts)
    - `provider` 'CIRCLE_MINT' | 'KRAKEN' | 'OPENFX' | 'ZUBA', nullable: Ledger provider (only for ledger accounts)
    - `assets` AccountAssetDto[]: Account assets with balances (for wallet and ledger accounts)
      - `currency` string, required: Currency symbol
      - `network` string: Blockchain network (only for wallet accounts)
      - `available_balance` string, required: Available balance as a decimal string in currency units. Precision depends on the currency, network, and account provider.
    - `created_by` 'CUSTOMER' | 'SYSTEM', required: Whether the customer registered this account (CUSTOMER) or Tesser synthesized it (SYSTEM).
    - `created_at` string, required: Creation timestamp
    - `updated_at` string, required: Last update timestamp
  - `pagination` Pagination, required
    - `page` number, required: Current page number.
    - `limit` number, required: Number of items per page.
    - `total` number, required: Total number of items.
    - `total_pages` number, required: Total number of pages.
    - `has_next` boolean, required: Whether there is a next page.
    - `has_prev` boolean, required: Whether there is a previous page.

## Other responses

- `400`: Invalid request data
- `401`: Authentication required or invalid credentials
- `500`: Internal server error

---

[API](https://skmtc.dev/tesser/apis/tesser-api.md) - [All operations](https://skmtc.dev/tesser/apis/tesser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tesser/apis/tesser-api/revisions/14f951e986b1?raw)