Retrieve a Transaction

Retrieve the details of a single transaction by its transaction ID.

Path Parameters

Parameter	Type	Required	Description
`id`	`string`	Yes	The unique transaction ID.

Authentication

This endpoint requires your API key.

x-api-key: YOUR_API_KEY

Endpoint

GET /v1/transactions/history/:id

{
  "data": {
    "id": "10b9747e-d97c-45ee-9f4c-1491d3cc08b5",
    "reference": "KYSHI-1778653189299",
    "status": "SUCCESS",
    "type": "CR",
    "paymentType": "Payment Link",
    "currency": "GHS",
    "amount": 24.82,
    "netAmount": 24.82,
    "feeBearer": "CUSTOMER",
    "fees": {
      "total": 6.1,
      "processorFee": 0,
      "vat": 3.15,
      "platformFee": 2.95,
      "stampDuty": 0,
      "others": {}
    },
    "settlement": {
      "amount": 2,
      "currency": "USD"
    },
    "conversionRate": {
      "from": "USD",
      "to": "GHS",
      "rate": 12.41
    },
    "customer": {
      "id": "16a29770-e118-4244-bca9-58c348631853",
      "firstName": "Ayo",
      "lastName": "Kyshi",
      "email": "[email protected]",
      "phoneNumber": null
    },
    "createdAt": "2026-05-13T06:19:49.288Z",
    "updatedAt": "2026-05-13T10:32:13.311Z"
  },
  "status": true,
  "message": "Success",
  "code": 200
}

Response Fields

Field	Type	Description
`id`	`string`	Unique transaction ID.
`reference`	`string`	Transaction reference.
`status`	`string`	Transaction status. Example: `PENDING`, `SUCCESS`, `FAILED`.
`type`	`string`	Transaction direction. `CR` means credit, `DR` means debit.
`paymentType`	`string`	Transaction source, such as `Payment`, `Payment Link`, or `Subscription`.
`currency`	`string`	Transaction currency.
`amount`	`number`	Transaction amount in the transaction currency.
`netAmount`	`number`	Amount credited after applicable merchant-borne fees.
`feeBearer`	`string`	Party responsible for fees. Either `CUSTOMER` or `MERCHANT`.
`fees`	`object`	Fee breakdown for the transaction.
`settlement`	`object`	Settlement amount and settlement currency.
`conversionRate`	`object`	FX conversion details, if applicable.
`customer`	`object`	Customer details attached to the transaction.
`createdAt`	`string`	Date the transaction was created.
`updatedAt`	`string`	Date the transaction was last updated.

Notes

The transaction must belong to the business linked to the API key.
The API key determines whether the request is processed in test or live mode.
If the transaction is not found, the API returns a 404 response.