Get Request by ID

Get request by id

get

This method returns the request that matches the entered ID + the corresponding challenge.

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

request_idintegerRequired

The request's ID.

Responses

200

Request object with corresponding challenge

application/json

created_byinteger · nullableOptionalDefault: nullExample: 12

created_onstring · date-timeRequired

expires_atstring · date-timeRequired

idintegerRequired

statusstring · enumRequiredExample: PENDING_APPROVALPossible values:

target_idintegerRequiredExample: 10

target_typestring · enumRequiredExample: TRANSACTIONPossible values:

typestring · enumRequiredExample: CREATE_TRANSACTIONPossible values:

used_admin_groupinteger · nullableOptional

Admin Group used to create and approve the request

Default: nullExample: 1

404

RequestWithChallenge not found

application/json

get

/requests/{request_id}

HTTPcURLJavaScriptPython

GET /requests/{request_id} HTTP/1.1
X-Ledger-API-Key: YOUR_API_KEY
X-Ledger-API-User: YOUR_API_KEY
Accept: */*

{
  "challenge": "{\"challenge\":\"eyJhbnRpcmVwbGF5IjoiQUM4NjY3QTU1Qjc0REQwMDI4QkU1N0YzMzBGNjVCQ0Y1M0UyODkzMDc4MzRBQkQxQ0VDNkYyOUFFNTIwNkI5MSIsImRhdGEiOnsidHJhbnNhY3Rpb25fZGF0YSI6eyJhY2NvdW50X25hbWUiOiJteSBidGMgYWNjb3VudCIsImFtb3VudCI6IjEwMDAiLCJjdXJyZW5jeSI6ImJpdGNvaW4gdGVzdG5ldCIsIm1heF9mZWVzIjoiNDAxOCIsInJlY2lwaWVudCI6InRiMXF5N3M5YzJ4d3F5NHF5dmowa3lxN2g1Z2g0cnhnZGxqZHMwdDludiJ9LCJ0cmFuc2FjdGlvbl90eXBlIjoiQklUQ09JTl9MSUtFX1NFTkQifSwidHlwZSI6IkFQUFJPVkVfVFJBTlNBQ1RJT04ifQ\",\"id\":6}",
  "created_by": 12,
  "created_on": "2026-03-15T12:23:37.605Z",
  "expires_at": "2026-03-15T12:23:37.605Z",
  "id": 1,
  "status": "PENDING_APPROVAL",
  "target_id": 10,
  "target_type": "TRANSACTION",
  "type": "CREATE_TRANSACTION",
  "used_admin_group": 1
}