API ReferenceCountries
List countries
GET /v1/countries : enabled countries and their capability flags.
GET /v1/countries
Public endpoint: no authentication required. Returns every enabled country with its display metadata and capability flags. Cache it at boot or on a short TTL; it changes only when OuiPay opens or suspends a market.
curl https://api.ouipay.africa/v1/countriesResponse 200
{
"data": [
{
"code": "NG",
"name": "Nigeria",
"currency_code": "NGN",
"currency_symbol": "₦",
"phone_code": "+234",
"locale": "en-NG",
"flag_emoji": "🇳🇬",
"registration_enabled": true,
"exchange_enabled": true,
"payments_enabled": true,
"services_enabled": true,
"timezone": "Africa/Lagos",
"default_language_code": "en"
}
]
}| Field | Type | Notes |
|---|---|---|
code | string | ISO 3166-1 alpha-2 |
currency_code | string | Legal tender for wallets and services in this country |
registration_enabled | boolean | New accounts may register with this home country |
exchange_enabled | boolean | Exchange corridors operate for this country |
payments_enabled | boolean | Collections and payouts operate |
services_enabled | boolean | The services catalogue is live; see /services?country= |
These flags describe the market, not the customer. Per-service and per-method availability resolve on the services endpoints for the authenticated account.
Errors
| HTTP | error.code | Cause |
|---|---|---|
| 429 | RATE_LIMITED | Boot throttling |