Ledger Enterprise
API Documentation V1
API Documentation V1
  • GETTING STARTED
    • Welcome
    • Getting Started
    • Authentication
    • Rate Limits
    • Pagination
  • tutorials
    • Register a new API User
    • First Steps as an API User
    • Generate Reporting API Keys
    • Manage Reporting API Keys
  • REFERENCE
    • API reference
      • Accounts
        • Addresses
        • Balances
          • History
        • Currency
        • History
        • Labels
        • Nft collections
        • Nft portfolio
        • Nfts
        • Sync
        • Tokens
        • Erc20 children accounts
      • Api users
        • Register
      • Currencies
        • Tokens
      • Digests
        • History
      • Entities
        • History
        • Users
      • Groups
        • History
      • Labels
      • Messages
        • History
      • Organization
      • Pledges
      • Requests
        • Approve
        • Challenge
          • Reject
        • Governance status
        • Reject
      • Settlements
      • Transactions
        • Estimate fees
        • Fees
        • Approve
        • History
        • Labels
        • Reject
      • Users
        • History
      • Whitelists
        • History
      • Auth
        • Token
          • Refresh
      • Compliance
        • Address risk
        • Sanctions
      • Notifications
        • Configuration
    • Specification
Powered by GitBook
On this page
  1. REFERENCE
  2. API reference
  3. Transactions

Approve

PreviousFeesNextHistory

Approve Transaction

post

In this endpoint, enter the exact same values that were used when creating the transaction (for example, max_fees must be the exact same values).

You can retrieve transactions "pending approval" with GET /transactions?status=PENDING_APPROVAL.

However, you should NOT trust those values and you should implement your own source of trust.

Authorizations
Path parameters
transaction_idintegerRequired

The transaction's ID.

Body
account_namestringRequired

The account's name.

amountstring | nullableOptional

The amount to be sent, in the currency's lowest unit. For Smart Contract interaction, use "0" instead of null

Default: nullPattern: ^[0-9]*(\.[0-9]+)?$
coin_fieldsone of | nullableOptional

coin specific data

Default: null
or
or
or
or
or
or
or
or
or
max_feesstring | nullableOptional

The transaction's max fees, in the currency's lowest unit.

Default: nullPattern: ^[0-9]*(\.[0-9]+)?$
recipientstringRequired

The recipient's address.

Responses
200
The approved transaction
application/json
400
Invalid transaction parameters
application/json
404
Transaction not found
application/json
post
POST /transactions/{transaction_id}/approve HTTP/1.1
Host: 
X-Ledger-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "account_name": "text",
  "amount": "text",
  "coin_fields": {
    "utxo_picking_strategy": "DEEP_OUTPUTS_FIRST"
  },
  "max_fees": "text",
  "recipient": "text"
}
{
  "account_id": 1,
  "account_index": 0,
  "amount": "1432199",
  "block": {
    "details": {
      "ANY_ADDITIONAL_PROPERTY": null
    },
    "hash": "0x3bb33b6cc7c4aeea0e7383ddd8ef238c44abe8e3d73ffa27b78dd130a2a56687",
    "height": 7463221,
    "time": "2020-12-11T12:56:35.370946+00:00"
  },
  "broadcast_on": "2020-12-11T12:56:35.370946+00:00",
  "coin_fields": {
    "fees_per_byte": 10
  },
  "compliance": {
    "registration_ids": {
      "chainalysis": "906ff226-8b64-11eb-8e52-7b35a3dc1742"
    },
    "risk": {
      "provider_details": {
        "chainalysis": [
          {
            "category_id": 3,
            "exposure_type": "DIRECT",
            "provider_id": "906ff226-8b64-11eb-8e52-7b35a3dc1742",
            "risk": "Severe",
            "service": "OFAC SDN Blender.io 2022-05-06",
            "value": 8868.24
          }
        ]
      },
      "risk": "HIGH"
    }
  },
  "confirmations": 28,
  "created_by": 5,
  "created_on": "2025-05-30T17:58:15.017Z",
  "currency": "bitcoin",
  "currency_family": "ethereum",
  "failure_reasons": {
    "client_reason": "human readable message",
    "reason": "detail"
  },
  "fees": 17500,
  "id": 1,
  "interaction_type": "text",
  "labels": [
    {
      "id": 1,
      "info": {
        "color": "#fe3423",
        "description": "Flag resources as potentially harmfull"
      },
      "name": "SPAM"
    }
  ],
  "last_request": 1,
  "max_fees": 2100,
  "metadata": {
    "stake_pubkey": "text"
  },
  "min_confirmations": 6,
  "notes": [
    {
      "content": "some information about this transaction",
      "title": "a note title"
    }
  ],
  "recipient": "tb1q2tvjts80vthcywq9au2yynpezca57mvv0j7lzm",
  "senders": [
    "0x0D9377F84af90e6936973aEF3063fe6e16ca693e"
  ],
  "speed": "NORMAL",
  "status": "PENDING_APPROVAL",
  "tx_hash": "cd199dd0c61ff75c7a442e425771fedfe07e191a76aed64b6a311ec4a369b20e",
  "type": "SEND",
  "uid": "text"
}