List accounts

You can use your access token to list the accounts you have access to in this workspace. Make a GET request to the search accounts endpoint:

Bash

curl --request GET \
  --url https://api.vault.ledger.com/accounts \
  --header 'authorization: Bearer {{access_token}}' \
  --header 'content-type: application/json' \
  --header 'x-ledger-workspace: minivault'

JSON

{
  "edges": [
    {
      "cursor": 0,
      "node": {
        "address": null,
        "available_balance": "5719662",
        "balance": "5719662",
        "coin_fields": null,
        "contract_address": null,
        "created_by": 5,
        "created_on": "2023-12-13T20:27:18.887023+00:00",
        "currency": "bitcoin_testnet",
        "derivation_path": "84'/1'/3'",
        "governance_rules": [
        ...
        ],
        "id": 3,
        "index": 3,
        "labels": [],
        "last_request": 24,
        "name": "Exchange TBTC",
        "parent": null,
        "pending_balance": "0",
        "status": "ACTIVE",
        "type": "Bitcoin",
        "xpub": null
      }
    },
    {
      "cursor": 1,
      "node": {
        "address": null,
        "available_balance": "20298",
        "balance": "20298",
        "coin_fields": null,
        "contract_address": null,
        "created_by": 5,
        "created_on": "2023-12-13T20:26:57.395657+00:00",
        "currency": "bitcoin_testnet",
        "derivation_path": "84'/1'/1'",
        "governance_rules": [
        ...
        ],
        "id": 2,
        "index": 1,
        "labels": [],
        "last_request": 23,
        "name": "ClientA COL TBTC 1",
        "parent": null,
        "pending_balance": "0",
        "status": "ACTIVE",
        "type": "Bitcoin",
        "xpub": null
      }
    }
  ],
  "page_info": {
    "count": 2,
    "has_next_page": false
  }
}

This request returns a list of accounts along with their details, including balance, currency, and status. This endpoint is paginated, to learn more about how pagination work please refer the the API documentation.