Fetch a transaction by reference
Look up a transaction by its reference - `DEP_…` for a deposit, `WDR_…` for a payment - as shown in webhooks and receipts. Older `CTX_` and `LNX_` references also work. Direct on-chain receives have no reference; look those up by `id`.
Authorization
KeyID Timestamp Nonce Signature X-Gyvar-Key<token>
Your key id, gyv_k_live_... or gyv_k_sandbox_....
In: header
X-Gyvar-Timestamp<token>
Unix seconds. Must be within 5 minutes of our clock.
In: header
X-Gyvar-Nonce<token>
A unique value per request. Replays are rejected.
In: header
X-Gyvar-Signature<token>
Ed25519 signature over the canonical string. See the Signing guide.
In: header
Path Parameters
reference*string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/transactions/reference/DEP_VVJCTHA7REI3HATP"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "direction": "in", "status": "successful", "currency": "USDC", "amount": "20.000000", "amount_minor": "20000000", "fee": "0.600000", "fee_minor": "600000", "created_at": "2019-08-24T14:15:22Z", "reference": "WDR_TBJWZFYIYTM3KPF5", "chain": "ethereum", "network": "onchain", "address": "string", "hash": "string", "invoice": "string", "address_reference": "string", "address_label": "string", "completed_at": "2019-08-24T14:15:22Z", "failure_code": "transfer_failed", "failure_message": "string", "settlement_currency": "GHS", "settlement_decimals": 0, "settlement_amount": "string", "settlement_amount_minor": "string", "rate": "string", "destination": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "string", "country": "string", "network": "string", "account_masked": "string", "rail": "momo" } }}