List network providers

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

{
  "status": true,
  "message": "Providers fetched successfully",
  "code": "ok",
  "data": [
    {
      "id": "prv_01HXYZ",
      "name": "Access Bank",
      "code": "044",
      "network": "bank",
      "active": true
    }
  ],
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Supported Countries

List network providers

List network providers available in a country. Filter by network to narrow to banks, mobile money operators, or other payment networks.

You need a provider_id when creating a fiat beneficiary — it tells us which bank or mobile money operator to route the payout through.

Not every country returns rows. United States bank payouts use routing numbers on the beneficiary instead of a provider catalog, so you typically see an empty data array for US. Crypto networks are not country-scoped here.

When you omit network, we return providers across all networks for this country.

Path parameters

countryCode — ISO 3166-1 alpha-2 country code (e.g. NG, KE). Matched case-insensitively.

Query parameters

network (optional) — narrows the list to a single settlement network.
active (optional, boolean) — when true, returns only providers currently accepting traffic.

Example

GET /v1/countries/NG/providers?network=bank&active=true

GET

countries

{countryCode}

providers

List network providers

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

{
  "status": true,
  "message": "Providers fetched successfully",
  "code": "ok",
  "data": [
    {
      "id": "prv_01HXYZ",
      "name": "Access Bank",
      "code": "044",
      "network": "bank",
      "active": true
    }
  ],
  "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.

Path Parameters

countryCode

string

required

Pattern: [^\/#\?]+?

Query Parameters

network

string

active

string

Response

Providers fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Providers fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object[]

required

Show child attributes