Transactions

Get transaction

Retrieve a transaction by its ID with the TypeScript SDK.

GET/transactions/{transaction_id}

Use blnk.Transactions.get to fetch a single transaction by its transaction ID.

Call the method

const response = await blnk.Transactions.get(
  'txn_93c3f6dc-9c2c-46b0-89c5-1814cef4d0e4',
);

Field	Type	Description
`transactionId`	`string`	Transaction ID to retrieve.

Use the transaction details

Read response.data for status, amounts, source, destination, and metadata. Use the transaction ID for refunds, inflight updates, or lineage queries.

Response

{
  "precise_amount": 300,
  "amount": 3,
  "precision": 100,
  "transaction_id": "txn_93c3f6dc-9c2c-46b0-89c5-1814cef4d0e4",
  "parent_transaction": "",
  "source": "bln_845bbf20-cc0c-41d2-810b-24f104f1cb8b",
  "destination": "bln_e92a1ba7-92c7-427c-8c8f-bfdca55c875d",
  "reference": "ref_04551509-d7d3-4eab-a1fd-2eb12809b5a4",
  "currency": "BTC",
  "description": "test",
  "status": "APPLIED",
  "hash": "0b9c25fb5b00d6c71cb4ca87026bf6dc316e63353d3330deb588bd0b3d74dcc0",
  "allow_overdraft": false,
  "inflight": false,
  "created_at": "2025-02-08T13:36:42.748594Z",
  "scheduled_for": "0001-01-01T00:00:00Z",
  "meta_data": {
    "customer_id": "12345",
    "payment_method": "card"
  }
}

Field	Type	Description
`transaction_id`	`string`	Unique ID for the transaction.
`status`	`string`	Current status of the transaction.
`source`	`string`	Source balance.
`destination`	`string`	Destination balance.
`reference`	`string`	Reference you supplied at create time.
`meta_data`	`Record<string, unknown>`	Metadata stored with the transaction.