List countries

curl --request GET \
  --url https://api.paystack.com/v1/countries/ \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Supported countries fetched successfully",
  "code": "ok",
  "data": [
    {
      "code": "NG",
      "name": "Nigeria",
      "currencies": [
        "NGN",
        "USDC"
      ],
      "networks": [
        "bank"
      ]
    }
  ],
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Supported Countries

List countries

List countries where GlobalStack operates. Each row includes supported ISO currency codes and the payment networks available in that country.

Use this as a starting point for coverage. For per-currency limits and capability flags, use GET /v1/currencies. For banks and mobile money operators you can pass as provider_id on fiat beneficiaries, use GET /v1/countries/{country_code}/providers.

This is reference data — fetch once and cache client-side.

All filters are optional.

Filter behavior

currency — restricts to countries that support the given currency code. Matched case-insensitively and must satisfy ^[A-Z0-9]{2,10}$.
network — restricts to countries that support the given settlement network (e.g. bank).

Example

GET /v1/countries?currency=NGN&network=bank

GET

countries

List countries

curl --request GET \
  --url https://api.paystack.com/v1/countries/ \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Supported countries fetched successfully",
  "code": "ok",
  "data": [
    {
      "code": "NG",
      "name": "Nigeria",
      "currencies": [
        "NGN",
        "USDC"
      ],
      "networks": [
        "bank"
      ]
    }
  ],
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Query Parameters

currency

string

network

string

Response

Supported countries fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Supported countries fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object[]

required

Show child attributes