Skip to main content
GET
/
transactions
/
reference
/
{reference}
Get transaction by reference
curl --request GET \
  --url http://localhost:5001/transactions/reference/{reference} \
  --header 'X-blnk-key: <api-key>'
Use blnk.Transactions.getByReference to retrieve a transaction by reference.
blnk.Transactions.getByReference
const response = await blnk.Transactions.getByReference(
  'ref_04551509-d7d3-4eab-a1fd-2eb12809b5a4',
);
FieldDescription
referenceUnique reference passed when the transaction was created.

​
Response shape

200 OK
{
  "precise_amount": 300,
  "amount": 3,
  "rate": 0,
  "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",
  "meta_data": {
    "customer_id": "12345",
    "payment_method": "card"
  }
}
FieldDescription
transaction_idUnique ID for the transaction.
referenceReference you queried.
statusCurrent status of the transaction.

How transactions work

Money movement, statuses, and the transaction lifecycle.

Get transaction by reference

HTTP request and response schema.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.