Transactions

View transaction lineage

Read which providers funded a debit.

GET/transactions/{transaction_id}/lineage

Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

Path

transaction_idstringrequiredpath

Specifies the unique ID of the transaction whose lineage you want to retrieve.

Response

transaction_idstringrequired

The ID of the transaction being queried.

fund_allocationarray

Fund allocation breakdown for debit transactions from a lineage-enabled balance. Each amount is a string in minor units.

shadow_transactionsarrayrequired

Internal shadow transactions created for lineage tracking (each item is a transaction object).

curl -X GET "http://localhost:5001/transactions/{transaction_id}/lineage" \
  -H "X-blnk-key: <api-key>"

{
  "transaction_id": "txn_8d2ce2f0-0d75-4a91-9d43-2ad2c2e6b9ad",
  "fund_allocation": [
    { "provider": "stripe", "amount": "2500" }
  ],
  "shadow_transactions": [
    {
      "transaction_id": "txn_shadow_123",
      "reference": "ref_002_release_stripe_0",
      "precise_amount": "2500",
      "currency": "USD",
      "status": "APPLIED"
    }
  ]
}

{
  "error": "Transaction with ID 'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94' not found",
  "error_detail": {
    "code": "TXN_NOT_FOUND",
    "message": "Transaction with ID 'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94' not found",
    "details": {}
  }
}