Retrieve a single transaction for your business. The {id} value can be the transaction ID or reference, depending on what was stored for the transaction.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/transactions/history/{id}

Path Parameters

Field	Data Type	Required	Description
id	string	Yes	Transaction ID or transaction reference.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "id": "f6cbda33-1a40-4f2e-a211-fd87bd86cc4a",
    "reference": "ORDER-10001",
    "status": "SUCCESS",
    "type": "CR",
    "paymentType": "CARD",
    "currency": "NGN",
    "amount": 1000,
    "grossAmount": 1000,
    "customerPaidAmount": 1000,
    "netAmount": 990,
    "creditedAmount": 990,
    "feeBearer": "MERCHANT",
    "fees": {
      "total": 10,
      "processorFee": 0,
      "vat": 0,
      "platformFee": 10,
      "stampDuty": 0,
      "others": {}
    },
    "settlement": {
      "amount": 1000,
      "currency": "USD"
    },
    "customer": {
      "email": "[email protected]"
    },
    "createdAt": "2026-05-20T10:20:00.000Z",
    "updatedAt": "2026-05-20T10:20:00.000Z"
  }
}