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

Policies

PreviousWhitelistsNextEntities

List policies

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
namestringOptional

Search by matching name

isPrivatebooleanOptional

Search private policies

Default: false
sortBystring · enumOptional

Sort by attribute

Default: createdAtPossible values:
sortOrderstring · enumOptional

Sort order

Default: ascPossible values:
Responses
200
Successful response
application/json
default
Error response
application/json
get
GET /rest/policies 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,
      "name": "text",
      "description": "text",
      "users": [
        {
          "id": "text",
          "legacyId": 1,
          "legacyViewAll": true,
          "workspaceName": "text",
          "name": "text",
          "deviceUserId": "text",
          "role": "ADMIN",
          "status": "ACTIVE",
          "createdAt": "2025-06-21T03:58:00.755Z",
          "updatedAt": "2025-06-21T03:58:00.755Z"
        }
      ],
      "groups": [
        {
          "id": "text",
          "legacyId": 1,
          "name": "text",
          "description": "text",
          "status": "ACTIVE",
          "createdAt": "2025-06-21T03:58:00.755Z",
          "updatedAt": "2025-06-21T03:58:00.755Z"
        }
      ],
      "createdAt": "2025-06-21T03:58:00.755Z",
      "updatedAt": "2025-06-21T03:58:00.755Z",
      "currency": "text",
      "type": "ACCOUNT_POLICY",
      "rules": [
        {
          "operationType": "SEND",
          "threshold": {
            "min": "text",
            "max": "text"
          },
          "whitelistIds": [
            "text"
          ],
          "reviewSteps": [
            {
              "quorum": 1,
              "userIds": [
                "text"
              ]
            }
          ]
        }
      ],
      "whitelists": [
        {
          "id": "text",
          "legacyId": 1,
          "name": "text",
          "status": "ACTIVE",
          "addresses": [
            {
              "name": "text",
              "currency": "text",
              "address": "text",
              "destinationTags": [
                "text"
              ]
            }
          ],
          "createdAt": "2025-06-21T03:58:00.755Z",
          "updatedAt": "2025-06-21T03:58:00.755Z",
          "description": "text"
        }
      ]
    }
  ]
}

Get a single policy

get
Authorizations
Path parameters
idstringRequired

Id of the target policy

Responses
200
Successful response
application/json
Responseany of
default
Error response
application/json
get
GET /rest/policies/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "text",
  "legacyId": 1,
  "name": "text",
  "description": "text",
  "users": [
    {
      "id": "text",
      "legacyId": 1,
      "legacyViewAll": true,
      "workspaceName": "text",
      "name": "text",
      "deviceUserId": "text",
      "role": "ADMIN",
      "status": "ACTIVE",
      "createdAt": "2025-06-21T03:58:00.755Z",
      "updatedAt": "2025-06-21T03:58:00.755Z"
    }
  ],
  "groups": [
    {
      "id": "text",
      "legacyId": 1,
      "name": "text",
      "description": "text",
      "status": "ACTIVE",
      "createdAt": "2025-06-21T03:58:00.755Z",
      "updatedAt": "2025-06-21T03:58:00.755Z"
    }
  ],
  "createdAt": "2025-06-21T03:58:00.755Z",
  "updatedAt": "2025-06-21T03:58:00.755Z",
  "currency": "text",
  "type": "ACCOUNT_POLICY",
  "rules": [
    {
      "operationType": "SEND",
      "threshold": {
        "min": "text",
        "max": "text"
      },
      "whitelistIds": [
        "text"
      ],
      "reviewSteps": [
        {
          "quorum": 1,
          "userIds": [
            "text"
          ]
        }
      ]
    }
  ],
  "whitelists": [
    {
      "id": "text",
      "legacyId": 1,
      "name": "text",
      "status": "ACTIVE",
      "addresses": [
        {
          "name": "text",
          "currency": "text",
          "address": "text",
          "destinationTags": [
            "text"
          ]
        }
      ],
      "createdAt": "2025-06-21T03:58:00.755Z",
      "updatedAt": "2025-06-21T03:58:00.755Z",
      "description": "text"
    }
  ]
}
  • GETList policies
  • GETGet a single policy