Transfer API
Providers
This endpoint returns the list of operators and banks available for the different transaction types supported by SolFi.
Filtering
mobile_money— list mobile money operatorsbank— list operators of type bank
Supported countries
| Code | Country |
|---|---|
| CM | Cameroon |
| CF | Central African Republic |
| TD | Chad |
| CG | Republic of the Congo |
| GQ | Equatorial Guinea |
| GA | Gabon |
Method & URL
GEThttps://api.katika-bridge.com/providers
Query parameters
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| countryCode | string | No | Filter by country code (uppercase) |
| type | string | No | Filter by type (mobile_money or bank) |
| search | string | No | Search by name or code (idantitiCode) |
| 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 |
Sample request
GET /providers
curl -X GET "https://api.katika-bridge.com/providers?countryCode=CM&type=mobile_money&all=true" \
-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": "Providers retrieved successfully",
"data": {
"currentPage": 1,
"previousPage": null,
"nextPage": null,
"count": 1,
"totalCount": 1,
"totalPages": 1,
"result": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Orange Money Côte d'Ivoire",
"type": "mobile_money",
"countryCode": "CI",
"idantitiCode": "Orange_CI",
"createdAt": "2024-01-15T08:30:00.000Z",
"updatedAt": "2024-06-20T14:12:00.000Z"
}
]
}
}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) |
The idantitiCode returned here is the value to send as provider when initiating a transaction.