Approve Transaction

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

Ledger_API_Key & Ledger_API_UserLedger_API_Key & Ledger_API_User & Ledger_Store_Auth_TokenLedger_API_UserLedger_API_User & Ledger_Store_Auth_Token

X-Ledger-API-KeystringRequired

If you've set up your API Key when initializing your LAM, you'll need to include it as a header along with the api user header. For more details, see step 5 of the get started documentation.

X-Ledger-API-UserstringRequired

(required) Username of a registered API User

Path parameters

transaction_idintegerRequired

The transaction's ID.

Body

application/json

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

account_idintegerRequiredExample: 1

account_indexintegerRequiredExample: 0

amountstring · nullableOptional

the transaction amount, in base units

Default: nullExample: 1432199Pattern: ^[0-9]*(\.[0-9]+)?$

broadcast_onstring · date-time · nullableOptionalDefault: nullExample: 2020-12-11T12:56:35.370946+00:00

coin_fieldsone of · nullableOptionalDefault: nullExample: {"fees_per_byte":10}

or

or

or

or

or

or

or

or

confirmationsintegerRequiredExample: 28

created_byintegerRequiredExample: 5

created_onstring · date-timeRequired

currencystring · enumRequiredExample: bitcoinPossible values:

currency_familystring · enumRequiredExample: ethereumPossible values:

feesstring · nullableOptional

the transaction fee paid, in base units

Default: nullExample: 17500Pattern: ^[0-9]*(\.[0-9]+)?$

idintegerRequired

interaction_typestring · nullableOptionalDefault: null

last_requestinteger · nullableOptionalDefault: null

max_feesstring · nullableOptional

Max fees represent the highest possible fee amount you will pay to broadcast this transaction, in base units. The final fees, calculated once the transaction is approved by the last Operator, might be lower, but will never exceed that amount. See https://help.vault.ledger.com/Content/transactions/tx.html for details

Default: nullExample: 2100Pattern: ^[0-9]*(\.[0-9]+)?$

metadataone of · nullableOptionalDefault: null

or

min_confirmationsintegerRequiredExample: 6

recipientstring · nullableOptionalDefault: nullExample: tb1q2tvjts80vthcywq9au2yynpezca57mvv0j7lzm

sendersstring[] · nullableOptional

Only available once the transaction has been submitted to the blockchain

Default: nullExample: ["0x0D9377F84af90e6936973aEF3063fe6e16ca693e"]

speedstring · enum · nullableOptionalDefault: nullExample: NORMALPossible values:

statusstring · enumRequiredExample: PENDING_APPROVALPossible values:

tx_hashstring · nullableOptionalDefault: nullExample: cd199dd0c61ff75c7a442e425771fedfe07e191a76aed64b6a311ec4a369b20e

typestring · enumRequiredExample: SENDPossible values:

uidstring · nullableOptionalDefault: null

400

Invalid transaction parameters

application/json

404

Transaction not found

application/json

post

/transactions/{transaction_id}/approve

HTTPcURLJavaScriptPython

POST /transactions/{transaction_id}/approve HTTP/1.1
X-Ledger-API-Key: YOUR_API_KEY
X-Ledger-API-User: 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": "2026-03-15T12:42:39.695Z",
  "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"
}