Transfer API
History of transactions
Retrieve the full list of your transactions with filtering and pagination, for reconciliation, reporting or back-office views.
Method & URL
GEThttps://api.katika-bridge.com/transactions
Query parameters
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| status | string | No | Filter by status: PENDING, SUCCESS, FAILED |
| paymentMethod | string | No | mobile_money or bank |
| provider | string | No | Filter by operator or bank code |
| countryCode | string | No | Filter by country code (uppercase) |
| search | string | No | Search by reference, externalId or beneficiary |
| startDate | string (ISO) | No | Start of the period |
| endDate | string (ISO) | No | End of the period |
| page | number | No | Page number (default: 1) |
| limit | number | No | Number of results per page (default: 10) |
| all | boolean | No | Return all results without pagination |
Example request
GET /transactions
curl -X GET "https://api.katika-bridge.com/transactions?status=SUCCESS&page=1&limit=20" \
-H "x-api-key: your_api_key_here" \
-H "x-api-secret: your_api_secret_here"Success response (200 OK)
200 OK
{
"error": false,
"statusCode": 200,
"message": "Transactions retrieved successfully",
"data": {
"currentPage": 1,
"previousPage": null,
"nextPage": 2,
"count": 20,
"totalCount": 143,
"totalPages": 8,
"result": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"externalId": "550e8400-e29b-41d4-a716-446655440000",
"reference": "KTK-TR-882910",
"amount": 10000,
"feeAmount": 150,
"totalAmount": 10150,
"currency": "XAF",
"status": "SUCCESS",
"paymentMethod": "mobile_money",
"country": "CM",
"provider": "Orange_CM",
"walletNumber": "237690000000",
"recipientName": "John Doe",
"createdAt": "2026-02-02T17:04:09.588Z",
"updatedAt": "2026-02-02T17:06:21.104Z"
}
]
}
}Pagination metadata (currentPage, nextPage, totalCount, totalPages) sits alongside the result array so you can page through large histories safely.
Possible errors
| HTTP code | Description |
|---|---|
| 400 | Invalid request (missing or malformed parameters) |
| 400 / 404 | Authentication error — see Authentication |
| 500 | Server error (internal problem during request processing) |