---
title: "Get accounts"
description: "Retrieve a list of internal accounts with optional filters and pagination."
protocol: rest
method: GET
endpoint: "/v1/accounts"
baseUrl: "https://api.gravv.xyz"
group: "Accounts"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get accounts

<Endpoint method="GET" path="/v1/accounts" />

Retrieve a list of internal accounts with optional filters and pagination.

## Query Parameters

<ParamField name="items_per_page" query="items_per_page" type="string">
  Number of items per page (pagination limit)
</ParamField>

<ParamField name="page" query="page" type="string">
  Page number for pagination
</ParamField>

<ParamField name="customer_id" query="customer_id" type="string">
  Filter accounts by customer ID
</ParamField>

<ParamField name="blockchain_network" query="blockchain_network" type="string">
  Filter accounts by blockchain network

  Possible values: `polygon`, `stellar`, `ethereum`, `solana`, `avalanche`
</ParamField>

<ParamField name="label" query="label" type="string">
  Filter accounts by their label
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | List of accounts |
| `400` | Request failed. All gateway errors are returned as HTTP 400 with this envelope. |

### 200 response

<ResponseField name="data" type="object" required>

  <Expandable title="properties">
    <ResponseField name="items" type="object[]">

      <Expandable title="properties">
        <ResponseField name="id" type="string">
        </ResponseField>

        <ResponseField name="label" type="string">
        </ResponseField>

        <ResponseField name="date_created" type="string">
        </ResponseField>

        <ResponseField name="wallet_address" type="string">
        </ResponseField>

        <ResponseField name="blockchain_network" type="string">
        </ResponseField>

        <ResponseField name="type" type="string">
          Account kind.
        </ResponseField>

        <ResponseField name="customer_id" type="string">
        </ResponseField>

        <ResponseField name="capabilities" type="string[]">
        </ResponseField>

        <ResponseField name="currency" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_id" type="string">
        </ResponseField>

        <ResponseField name="tenant_name" type="string">
        </ResponseField>

        <ResponseField name="tenant_id" type="string">
        </ResponseField>

        <ResponseField name="tier" type="string">
        </ResponseField>

        <ResponseField name="status" type="string">

          Possible values: `active`, `frozen`, `deleted`, `pending`
        </ResponseField>

        <ResponseField name="category" type="string">
        </ResponseField>

        <ResponseField name="balance" type="string">
        </ResponseField>

        <ResponseField name="is_tokenized" type="boolean">
        </ResponseField>

        <ResponseField name="inflow_behavior" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_name" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_address" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_beneficiary_address" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_beneficiary_name" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_account_number" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_routing_number" type="string">
        </ResponseField>

        <ResponseField name="assets" type="object[]">

          <Expandable title="properties">
            <ResponseField name="balance" type="string">
            </ResponseField>

            <ResponseField name="decimals" type="integer">
            </ResponseField>

            <ResponseField name="symbol" type="string">
            </ResponseField>

          </Expandable>
        </ResponseField>

        <ResponseField name="metadata" type="object">
        </ResponseField>

      </Expandable>
    </ResponseField>

    <ResponseField name="page" type="integer">
    </ResponseField>

    <ResponseField name="items_per_page" type="integer">
    </ResponseField>

    <ResponseField name="total_pages" type="integer">
    </ResponseField>

    <ResponseField name="total_items" type="integer">
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseField name="error" type="null" required>
</ResponseField>

### 400 response

<ResponseField name="data" type="null" required>
</ResponseField>

<ResponseField name="error" type="string" required>
  Human-readable error message.
</ResponseField>

## Authorization

- **ApiKeyAuth**