Reject Transaction

Reject a transaction

post

Reject a transaction pending approval.

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.

Responses

200

The rejected 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

404

Transaction not found

application/json

post

/transactions/{transaction_id}/reject

HTTPcURLJavaScriptPython

POST /transactions/{transaction_id}/reject HTTP/1.1
X-Ledger-API-Key: YOUR_API_KEY
X-Ledger-API-User: YOUR_API_KEY
Accept: */*

{
  "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-15T11:56:20.228Z",
  "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"
}