Ledger Enterprise
API Documentation V2
API Documentation V2
  • Introduction
    • Getting Started
    • Overview
  • Guides
    • Authentication
    • Balance Reporting Bot
      • 1. Project setup
      • 2. Connect to revault-api
      • 3. Fetch accounts balances
      • 4. Conclusion
  • reference
    • API reference
      • Users
      • Accounts
        • Transactions
      • Groups
      • Whitelists
      • Policies
      • Entities
      • Requests
        • Generate registration challenge
        • Confirm registration challenge
        • Challenge
        • Approve
        • Reject
      • Auth
        • Token
          • Refresh
      • Permissions
        • Allowed actions
        • Resources
      • Assets
        • Currencies
        • Tokens
      • Tradelink
        • Network
          • Blueprint
    • Specification
Powered by GitBook
On this page
  1. reference
  2. API reference

Accounts

PreviousUsersNextTransactions

List accounts

get
Authorizations
Query parameters
pageany ofOptional

Which page to fetch

Default: 1
notOptional
or
integer · min: 1Optional
pageSizeany ofOptional

Page size to use

Default: 30
notOptional
or
integer · min: 1 · max: 30Optional
statusstring · enumOptional

Account status

Possible values:
namestringOptional

Search by matching name

governanceTypestring · enumOptional

Account governance type

Possible values:
sortBystring · enumOptional

Sort by attribute

Default: createdAtPossible values:
sortOrderstring · enumOptional

Sort order

Default: ascPossible values:
skipLiveDatabooleanOptional

Do not fetch live data (e.g. balance and staking) from blockchain

Default: false
Responses
200
Successful response
application/json
default
Error response
application/json
get
GET /rest/accounts HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "page": 1,
  "next": 1,
  "prev": 1,
  "pageSize": 1,
  "total": 1,
  "results": [
    {
      "id": "text",
      "legacyId": 1,
      "status": "ACTIVE",
      "name": "text",
      "currency": "text",
      "index": 1,
      "derivationPath": "text",
      "createdAt": "2025-06-20T20:40:02.679Z",
      "updatedAt": "2025-06-20T20:40:02.679Z",
      "balance": {
        "total": "text",
        "pending": "text"
      },
      "asset": {
        "type": "BITCOIN_LIKE",
        "xpub": "text"
      },
      "governance": {
        "type": "CLASSIC",
        "policyId": "text"
      }
    }
  ]
}

Get a single account

get
Authorizations
Path parameters
idstringRequired

Id of the target account

Query parameters
skipLiveDatabooleanOptional

Do not fetch live data (e.g. balance and staking) from blockchain

Default: false
Responses
200
Successful response
application/json
default
Error response
application/json
get
GET /rest/accounts/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "text",
  "legacyId": 1,
  "status": "ACTIVE",
  "name": "text",
  "currency": "text",
  "index": 1,
  "derivationPath": "text",
  "createdAt": "2025-06-20T20:40:02.679Z",
  "updatedAt": "2025-06-20T20:40:02.679Z",
  "balance": {
    "total": "text",
    "pending": "text"
  },
  "asset": {
    "type": "BITCOIN_LIKE",
    "xpub": "text"
  },
  "governance": {
    "type": "CLASSIC",
    "policyId": "text"
  }
}
  • GETList accounts
  • GETGet a single account