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 client.Transaction.GetByReference to retrieve a transaction by reference.
1

Call the method

client.Transaction.GetByReference
transaction, resp, err := client.Transaction.GetByReference(
	"ref_04551509-d7d3-4eab",
)
FieldTypeDescription
referencestringUnique reference passed when the transaction was created.
2

Use the transaction details

Use transaction.TransactionID when you need to refund, update inflight status, or inspect lineage.
3

Response

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"
  }
}
FieldTypeDescription
transaction_idstringUnique ID for the transaction.
referencestringReference you queried.
statusstringCurrent 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.