Phone Number: Country Requirements
Every country uses the same endpoint (POST /verify/phone) and the same response shape; only the inputs and returned name fields differ. This page lists what each country expects. For the request/response flow itself, see the Phone Number guide.
| Country | Code | networkCode | Supported values | Name fields returned |
|---|---|---|---|---|
| Nigeria | NG | No | — | firstName, lastName, fullName, dateOfBirth |
| Ghana | GH | Yes | MTN, VOD, ATM | fullName only |
| Uganda | UG | No | — | fullName only |
| Zambia | ZM | Yes (lowercase) | airtel, mtn, zamtel | fullName only |
| Tanzania | TZ | Yes | 503, 504, 501, 506, 507 | firstName, lastName, fullName |
| Ethiopia | ET | Yes | TELEBIRR, MPESA | fullName only |
| Senegal | SN | Yes | ORANGE | firstName, lastName, fullName |
| Cameroon | CM | Yes | ORANGE, MTN | firstName, lastName, fullName |
| Benin | BJ | Yes | MTN, MOOV | firstName, lastName, fullName |
| Togo | TG | Yes | TMONEY | firstName, lastName, fullName |
Note
Where networkCode is required, omitting it returns NETWORK_CODE_REQUIRED, and an unsupported value returns INVALID_NETWORK_CODE.
Nigeria
Local (08000000000) or E.164 (+2348000000000) format. No networkCode; the operator is resolved automatically.
{
"phoneNumber": "08000000000",
"country": "NG"
}Returns firstName, lastName, fullName, and dateOfBirth (dateOfBirth may be absent depending on the operator).
Sandbox: 08000000000 with country NG returns a predictable success.
Ghana
Local (0240000000) or E.164 (+233240000000) format. networkCode is required:
| Operator | networkCode |
|---|---|
| MTN Ghana | MTN |
| Vodafone Ghana | VOD |
| AirtelTigo | ATM |
{
"phoneNumber": "0240000000",
"country": "GH",
"networkCode": "MTN"
}Returns fullName only. Individual name components and dateOfBirth are not available.
Uganda
Local (0700000000) or E.164 (+256700000000) format. No networkCode; the operator is resolved automatically.
{
"phoneNumber": "0700000000",
"country": "UG"
}Returns fullName only. Individual name components and dateOfBirth are not available.
Zambia
Local (0977000000) or E.164 (+260977000000) format. networkCode is required and must be lowercase:
| Operator | networkCode |
|---|---|
| Airtel Zambia | airtel |
| MTN Zambia | mtn |
| Zamtel | zamtel |
{
"phoneNumber": "0977000000",
"country": "ZM",
"networkCode": "mtn"
}Warning
Sending MTN instead of mtn returns INVALID_NETWORK_CODE. Zambia's codes are lowercase, unlike Ghana's.
Returns fullName only. Individual name components and dateOfBirth are not available.
Tanzania
E.164 format (+255621804189); the leading + is optional. Tanzania routes through the national interoperability hub covering all major mobile-money operators. networkCode is required:
| Operator | networkCode |
|---|---|
| Vodacom M-Pesa | 503 |
| Airtel Money | 504 |
| Tigo Pesa / Zantel | 501 |
| Halotel HaloPesa | 506 |
| Azam Mobile Money | 507 |
{
"phoneNumber": "+255621804189",
"country": "TZ",
"networkCode": "503"
}Returns firstName, lastName, and fullName. The response may also include an identity object carrying a 15-digit NIN when the hub has it.
Ethiopia
E.164 format (+251911000001). Ethiopia routes through the national interoperability hub covering Telebirr and M-Pesa wallets. networkCode is required:
| Operator | networkCode |
|---|---|
| Telebirr (Ethio Telecom) | TELEBIRR |
| M-Pesa | MPESA |
{
"phoneNumber": "+251911000001",
"country": "ET",
"networkCode": "TELEBIRR"
}Returns fullName only.
Note
Ethiopia returns ACCOUNT_NOT_FOUND when the number is not registered with the selected wallet operator. Try the other operator if applicable.
Senegal
E.164 format (+2210000000001); the leading + is optional. Routes through Orange Money. networkCode is required:
| Operator | networkCode |
|---|---|
| Orange Money | ORANGE |
{
"phoneNumber": "+2210000000001",
"country": "SN",
"networkCode": "ORANGE"
}Returns firstName, lastName, and fullName.
Cameroon
E.164 format (+2370000000001); the leading + is optional. Routes through Orange Money and MTN Mobile Money. networkCode is required:
| Operator | networkCode |
|---|---|
| Orange Money | ORANGE |
| MTN Mobile Money | MTN |
{
"phoneNumber": "+2370000000001",
"country": "CM",
"networkCode": "MTN"
}Returns firstName, lastName, and fullName.
Benin
E.164 format (+2290000000001); the leading + is optional. Routes through MTN Mobile Money and Moov Money. networkCode is required:
| Operator | networkCode |
|---|---|
| MTN Mobile Money | MTN |
| Moov Money | MOOV |
{
"phoneNumber": "+2290000000001",
"country": "BJ",
"networkCode": "MTN"
}Returns firstName, lastName, and fullName.
Togo
E.164 format (+2280000000001); the leading + is optional. Routes through Togocom's T-Money service. networkCode is required:
| Operator | networkCode |
|---|---|
| T-Money (Togocom) | TMONEY |
{
"phoneNumber": "+2280000000001",
"country": "TG",
"networkCode": "TMONEY"
}Returns firstName, lastName, and fullName.