Retrieve accounts

You can retrieve one or all customer accounts.

Retrieve single account

Use the Get a single account endpoint to retrieve a customer's account. To do this, include your API key and the account id in the request:

curl --request GET \
     --url https://api.gravv.xyz/v1/accounts/<account id> \
     --header 'Api-Key: <Api key>'

You will get a response similar to this:

{
  "data": {
    "assets": [
      {
        "balance": "100",
        "decimals": 0,
        "symbol": "USDC"
      }
    ],
    "balance": "100.00",
    "blockchain_network": "polygon",
    "capabilities": [
      "transfer",
      "receive",
      "remittance"
    ],
    "currency": "USD",
    "customer_id": "d12ded01-9081-4a3c-a76c-70654f0a0175",
    "date_created": "2025-10-07T09:49:23Z",
    "id": "a4d83e55-435e-41c9-9a0b-dcb99f690c95",
    "label": "Bode Thomas",
    "status": "active",
    "tenant_id": "cd90c45c-fa78-4624-a80a-642be301c812",
    "tenant_name": "Dahmoh",
    "tier": "",
    "type": "regular",
    "virtual_account_bank_account_number": "900300758080",
    "virtual_account_bank_address": "1800 North Pole St., Orlando, FL 32801",
    "virtual_account_bank_beneficiary_address": "1206 BEAR CREEK RD APT 1100, Hung, NJ 12345, US",
    "virtual_account_bank_name": "Bank of Nowhere",
    "virtual_account_bank_routing_number": "101019644",
    "virtual_account_id": "73cea894-bca7-43e2-b278-02bd6d991e2e",
    "wallet_address": "0xf73bdd069dc31aa8f334b177b175936ba98237a2"
  },
  "error": null
}

Retrieve all accounts

Use the Get accounts endpoint to retrieve all customer accounts. Include your API key in the request:

curl --request GET \
     --url https://api.gravv.xyz/v1/accounts \
     --header 'Api-Key: <Api Key>'

You will get a response similar to this:

{
  "data": {
    "items": [
      {
        "assets": [
          {
            "balance": "0",
            "decimals": 0,
            "symbol": "USDC"
          }
        ],
        "balance": "0.00",
        "blockchain_network": "polygon",
        "capabilities": [
          "transfer",
          "receive",
          "remittance"
        ],
        "currency": "USD",
        "customer_id": "d12ded01-9081-4a3c-a76c-70654f0a0175",
        "date_created": "2025-10-07T17:37:19Z",
        "id": "9a032fd9-419f-4526-a1af-41159c68d78d",
        "label": "Bode Thomas",
        "status": "active",
        "tenant_id": "cd90c45c-fa78-4624-a80a-642be301c812",
        "tenant_name": "Dahmoh",
        "tier": "",
        "type": "regular",
        "virtual_account_bank_account_number": "900800921892",
        "virtual_account_bank_address": "1800 North Pole St., Orlando, FL 32801",
        "virtual_account_bank_beneficiary_address": "1206 BEAR CREEK RD APT 1100, Hung, NJ 12345, US",
        "virtual_account_bank_name": "Bank of Nowhere",
        "virtual_account_bank_routing_number": "101019644",
        "virtual_account_id": "82de4d81-a87f-4859-bc04-cf6958b10224",
        "wallet_address": "0xab8bbe4b479a835aba6b0f58279000498c44b8a8"
      },
      ...
    ],
    "items_per_page": 4,
    "page": 1,
    "total_pages": 1
  },
  "error": null
}