Api Documentation

Destinations & Banks

Overview

List supported destination countries, then fetch bank codes for a country when the rail is bank. Corridors are not limited to Tanzania.

List destinations

HTTP Method	GET
Endpoint URL	`/api/v2/remit/destinations`
Base URL	`https://base-url-here.com`
Description	Return country and currency pairs you can quote.

curl --location --request GET 'https://base-url-here.com/api/v2/remit/destinations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'X-Business-Id: 9'

{
    "success": true,
    "message": "Success",
    "data": [
        { "country": "TZ", "currency": "TZS" },
        { "country": "AE", "currency": "AED" },
        { "country": "BD", "currency": "BDT" },
        { "country": "GB", "currency": "GBP" },
        { "country": "GH", "currency": "GHS" },
        { "country": "IN", "currency": "INR" },
        { "country": "KE", "currency": "KES" },
        { "country": "NG", "currency": "NGN" },
        { "country": "PK", "currency": "PKR" },
        { "country": "RW", "currency": "RWF" },
        { "country": "UG", "currency": "UGX" },
        { "country": "US", "currency": "USD" },
        { "country": "ZA", "currency": "ZAR" }
    ]
}

List banks

HTTP Method	GET
Endpoint URL	`/api/v2/remit/banks`
Base URL	`https://base-url-here.com`
Description	Return banks for one destination country.

Query Parameters

Field	Type	Description	Required
country	string	ISO destination country, e.g. UG or KE. Must be a supported corridor.	Yes

Requests without country return HTTP 422. Unsupported country codes also return 422.

curl --location --request GET 'https://base-url-here.com/api/v2/remit/banks?country=UG' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'X-Business-Id: 9'

{
    "success": true,
    "message": "Success",
    "data": [
        {
            "bank_code": "0001",
            "bank_name": "Example Bank"
        }
    ]
}

Use bank_code and bank_name on verify and create when rail is bank. Bank list shape follows the payout provider.

Terms of Use & Legal

By using this API, you agree to our Terms of Service and Privacy Policy. Do not share sensitive data or credentials.