Skip to main content
GET
/
api
/
v3
/
customer
/
support
/
countries
Get supported countries
curl --request GET \
  --url https://sandbox-api.kotanipay.com/api/v3/customer/support/countries \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Countries retrieved successfully",
  "data": [
    {
      "countryCode": "KE",
      "name": "Kenya",
      "currency": "KES",
      "serviceType": "WITHDRAW",
      "isActive": true,
      "isEnabled": true,
      "requiresNetwork": false,
      "requiresAccountName": false,
      "iso3Code": "KEN",
      "supportedNetworks": [
        "MTN",
        "VODAFONE",
        "AIRTEL"
      ],
      "availableNetworks": [
        "MPESA",
        "AIRTEL"
      ]
    }
  ]
}
Get a list of all supported countries with their configurations, filterable by service type, currency, and status.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
serviceType
enum<string>

Filter by service type

Available options:
DEPOSIT,
CARD_DEPOSIT,
WITHDRAW,
DETAILS
Example:

"WITHDRAW"

​
currency
enum<string>

Filter by currency

Available options:
KES,
GHS,
NGN,
ZAR,
ZAR,
USD,
XOF,
ZMW,
XAF,
SLE,
CDF,
TZS,
UGX,
EGP,
MWK,
RWF,
ETB,
MZN,
LSL,
GNF,
USDT,
BTC,
ETH,
USDC
Example:

"KES"

​
countryCode
string

Filter by country code (e.g., KE, NG, GH)

Example:

"KE"

​
isActive
boolean

Filter by active status

Example:

true

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Countries retrieved successfully"

​
data
object[]