Retrieve transactions for your business. This public endpoint returns an integrator-friendly transaction list under transactions.

-H "x-api-key: your_secret_key"

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

Query Parameters

Field	Data Type	Required	Description
page	integer	No	Page to retrieve. Defaults to `1`.
limit	integer	No	Records per page. Maximum is `100`.
order	string	No	`ASC` or `DESC`. Defaults to `DESC`.
sort	string	No	Field to sort by. Defaults to `createdAt`.
query	string	No	Search by transaction reference.
currency	string	No	Filter by transaction currency.
startDate	string	No	ISO date/time start filter.
endDate	string	No	ISO date/time end filter.
type	string	No	Use `payouts` for transfer transactions or `paymentLinks` for payment-link transactions.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "transactions": [
      {
        "id": "f6cbda33-1a40-4f2e-a211-fd87bd86cc4a",
        "reference": "ORDER-10001",
        "status": "SUCCESS",
        "type": "CR",
        "paymentType": "CARD",
        "currency": "GHS",
        "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"
      }
    ]
  }
}