Retrieve Transaction History

Retrieve paginated transaction history for your business. You can filter transactions by currency.

Query Parameters

Parameter	Type	Required	Description
`currency`	`string`	No	Filters transactions by currency. Example: `GHS`, `KES`, `NGN`.
`page`	`number`	No	Page number to retrieve. Defaults to `1`.
`limit`	`number`	No	Number of transactions per page. Defaults to `100`, maximum `100`.
`startDate`	`string`	No	Filter transactions created from this date.
`endDate`	`string`	No	Filter transactions created up to this date.

Authentication

This endpoint requires your API key.

x-api-key: YOUR_API_KEY

Endpoint

GET /v1/transactions/history?currency=GHS&page=1&limit=20

{
  "data": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "transactions": [
      {
        "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": "Fred",
          "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 API key determines whether the request is processed in test or live mode.
The endpoint returns transactions for the business linked to the API key.
If currency is provided, only transactions in that currency are returned.