findTicket

Searches for a Fireblocks ticket by its Fireblocks Ticket ID or by the associated Settlement Transaction ID.

POST api/fireblocks/proxy/findTicket

Payload

{
    "ticketId": "1a1a1a1a-1a1a-1a1a-1a1a-1a1a1a1a1a1a",
    "transactionId": 1234567890
}

200 OK

{
  "data": { // some fields might be missing if not applicable. Check Fireblocks documentation for actual fields
    "id": "1a1a1a1a-1a1a-1a1a-1a1a-1a1a1a1a1a1a",
    "type": "ASYNC",
    "status": "OPEN",
    "expiresAt": "2026-01-01T00:00:00.000Z",
    "expiresIn": 10,
    "submittedAt": "2026-01-01T00:00:00.000Z",
    "createdByNetworkId": "11111111-aaaa-1111-aaaa-111111111111",
    "createdByNetworkIdName": "creator name",
    "canceledByNetworkIdName": "canceled name",
    "expiredAt": "2026-01-01T00:00:00.001Z",
    "canceledAt": "2026-01-01T00:00:00.001Z",
    "fulfilledAt": "2026-01-01T00:00:00.001Z",
    "dvpExecutionStatus": "status",
    "orderCreatedByNetworkId": "creator name",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "terms": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "asset": "ASSET",
        "amount": "1",
        "amountUsd": "1000",
        "fromNetworkId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "fromNetworkIdName": "sender name",
        "toNetworkId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "toNetworkIdName": "recipient name",
        "txHash": "tx_hash",
        "txStatus": "tx_status",
        "fbTxId": "fb_tx_id",
        "status": "CREATED",
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z",
        "ticketId": "1a1a1a1a-1a1a-1a1a-1a1a-1a1a1a1a1a1a",
        "dvpSrcDstVaultId": "dvpSrcDstVaultIdTermValue"
      }
    ],
    "note": "note",
    "direction": "INTERMEDIATE",
    "externalRefId": "1234567890", // ID of a Settlement Transaction
    "createdByMe": true,
    "canceledByMe": false
  }
}

400 Bad request

{
    "error": 9,  // error code might vary
    "errorDescription": [
        "INPUT_ERROR" // additional error details
    ]
}

Request parameters

Field name	Type	Description
ticketId	string	Optional. Fireblocks Ticket ID. Not needed if search ticket by linked Settlement Transaction ID (transactionId)
transactionId	Efx::OrderId	Optional. Settlement Transaction ID (transaction's order id) Not required when searching by Fireblocks Ticket ID (ticketId).