v1

latestOpenAPI 3.1.02026-07-24620123.6 KB

Get Transactions

Lists recent transactions for your account. Results are paginated and return up to 3 transactions by default. Pass limit to request up to 10 transactions per call. For status checks on a known transaction, use GET /api/b2b/transactions/{transactionId} with the transaction ID or external reference instead of polling this list endpoint.

get/api/b2b/transactions

Query parameters

currencystring

typestring

externalReferencestring

startDatestring

Format YYYY-MM-DD

endDatestring

Format YYYY-MM-DD

statusstring

pending, failed or successful

limitinteger

Number of transactions to return. Defaults to 3 and cannot exceed 10.

transactionIdstring

Used to get the transactions after the specified transactionId

Response

200

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "country": "KE",
      "amount": 2500,
      "senderAmount": 2500,
      "year": "2024",
      "destination": "Bank Account",
      "type": "withdrew",
      "chargeStatus": "successful",
      "transactionId": "onn4nQlnxWQbzZosaN57",
      "receiverAmount": 2500,
      "fullTimestamp": "2024-09-14T01:47:38+03:00",
      "senderCurrency": "KES",
      "month": "September",
      "beneficiary": {
        "country": "Kenya",
        "bankCode": "MoMo",
        "accountName": "John Doe",
        "destination": "MoMo",
        "currency": "KES",
        "accountNumber": "0712345678"
      },
      "currency": "KES",
      "receiverCurrency": "KES",
      "day": "Saturday",
      "status": "SUCCESSFUL"
    }
  ]
}