Africa ID Verification API

Use the same VerifyNow external API key model to run supported African identity checks, including Nigeria NIN and Zimbabwe national ID checks. This is separate from the South African POST /verify report types.

Base URL

https://www.verifynow.co.za/api/external

Authentication

Send your API key in the x-api-key header.

Sandbox

Set mode to sandbox for local mock results. Sandbox calls cost 0 credits and do not contact a live verification source.

Production Credits

6 credits per verification. This value follows the current pricing table.

Start A Job

Production calls are asynchronous. The POST creates a verification job and returns a status URL. Use an Idempotency-Key header in production so retries cannot create duplicate jobs.

POST /africa-verification

country

Supported country code

id_type

Supported ID type for the country

id_number

Identity number to verify

mode

sandbox or production

Optional matching fields: first_name, last_name, and dob in YYYY-MM-DD format.

Nigeria NIN Example

curl -X POST https://www.verifynow.co.za/api/external/africa-verification \
  -H "x-api-key: $VERIFYNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "country": "NG",
    "id_type": "NIN_V2",
    "id_number": "12345678901",
    "mode": "sandbox"
  }'

Zimbabwe National ID Example

curl -X POST https://www.verifynow.co.za/api/external/africa-verification \
  -H "x-api-key: $VERIFYNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "country": "ZW",
    "id_type": "NATIONAL_ID_NO_PHOTO",
    "id_number": "000000000A00",
    "mode": "sandbox"
  }'

Zimbabwe IDs may be entered with spaces or hyphens. VerifyNow removes that display formatting before running the check.

POST Response

A successful production request returns pending. A successful sandbox request returns completed with a mock result available through the status endpoint.

{
  "success": true,
  "jobId": "3d4d83b0-0f76-4b58-9e6b-6b45cfac2db2",
  "job_id": "3d4d83b0-0f76-4b58-9e6b-6b45cfac2db2",
  "status": "pending",
  "statusUrl": "https://www.verifynow.co.za/api/external/africa-verification/jobs/3d4d83b0-0f76-4b58-9e6b-6b45cfac2db2",
  "mode": "production",
  "reportType": "africa_verification_enhanced_kyc",
  "requiredCredits": 6
}

Fetch Job Status

The status endpoint returns only jobs that belong to the API key owner. Internal signatures and callback parameters are removed from returned results.

curl -X GET https://www.verifynow.co.za/api/external/africa-verification/jobs/{jobId} \
  -H "x-api-key: $VERIFYNOW_API_KEY"

GET /africa-verification/jobs/{jobId}

Supported Countries

Country	Code	ID Types	Sandbox Example
Cote d'Ivoire	CI	NATIONAL_ID_NO_PHOTO, RESIDENT_ID_NO_PHOTO	12345678901
Ghana	GH	GHANA_CARD_NO_PHOTO, VOTER_ID	GHA-123456789-0
Kenya	KE	ALIEN_CARD, KRA_PIN, NATIONAL_ID, TAX_INFORMATION, PASSPORT	123456
Nigeria	NG	BANK_ACCOUNT, BVN, NIN_V2, NIN_SLIP, V_NIN, PHONE_NUMBER, VOTER_ID	0123456789
Zambia	ZM	BANK_ACCOUNT, TPIN	1234567890123
Zimbabwe	ZW	NATIONAL_ID_NO_PHOTO	000000000A00

Nigeria NIN

Use country: "NG" and id_type: "NIN_V2". The sandbox fixture shown in the docs is 12345678901. Matching name and date-of-birth fields are optional unless requested by your integration workflow.

South Africa ID + Photo

South African ID + Photo remains in the main API docs under Home Affairs ID Photo using reportType: "home_affairs_id_photo" on POST /verify.

Returned Data By Check

A successful record can return the fields listed below. Fields that are unavailable from the selected issuing source are omitted rather than estimated.

Country	Check	Data returned	Important note
Cote d'Ivoire	National ID (No Photo)`NATIONAL_ID_NO_PHOTO`	Country, ID type and number, Full name, Date of birth, Gender, Address, Structured address	No photograph, phone number or document image is returned.
Cote d'Ivoire	Resident ID (No Photo)`RESIDENT_ID_NO_PHOTO`	Country, ID type and number, Full name, Date of birth, Gender, Address, Structured address	No photograph, phone number or document image is returned.
Ghana	Ghana Card (No Photo)`GHANA_CARD_NO_PHOTO`	Country, ID type and number, Full name, Date of birth, Gender	This Ghana Card check does not return a photograph.
Ghana	Voter ID`VOTER_ID`	Country, ID type and number, Issue date, Full name, Age, Photograph, Gender	The legacy voter ID returns age rather than a full date of birth.
Kenya	Alien Card`ALIEN_CARD`	Country, ID type and number, Full name, Date of birth, Gender, Address, Structured address	No photograph, phone number or document image is returned.
Kenya	KRA PIN`KRA_PIN`	Country, National ID number, KRA PIN as secondary ID number	This check returns the KRA PIN linked to the supplied Kenyan or alien ID, not a personal-information profile.
Kenya	National ID`NATIONAL_ID`	Country, ID type and number, Issue date, Full name, Date of birth, Photograph, Gender, Address, Structured address	Availability follows the issuing source record.
Kenya	Tax Info`TAX_INFORMATION`	Country, ID type and number, Full name, Address, Structured address	No date of birth, photograph, phone number, document image or gender is returned.
Kenya	Passport`PASSPORT`	Country, ID type and number, Issue date, Expiry date, Full name, Date of birth, Photograph, Gender, Address, Structured address	Availability follows the issuing source record.
Nigeria	Bank Account`BANK_ACCOUNT`	Country, ID type and account number, Account holder full name	The Nigeria bank-account check returns the account holder name only.
Nigeria	BVN`BVN`	Country, ID type and number, Issue date, Full name, Date of birth, Photograph, Phone number, Second phone number when available, Gender, Address, Structured address	Availability follows the issuing source record.
Nigeria	NIN V2`NIN_V2`	Country, ID type and number, Full name, Date of birth, Photograph, Phone number, Gender, Address, Structured address	Availability follows the issuing source record.
Nigeria	NIN Slip`NIN_SLIP`	Country, ID type and number, Full name, Date of birth, Photograph, Phone number, NIN slip document image, Gender, Address, Structured address	Availability follows the issuing source record.
Nigeria	Virtual NIN`V_NIN`	Country, ID type and number, Full name, Date of birth, Photograph, Phone number, Second phone number when available, Gender, Address, Structured address	Availability follows the issuing source record.
Nigeria	Phone Number`PHONE_NUMBER`	First-name match result, Middle-name match result, Last-name match result, Date-of-birth match result, Gender match result	This phone-number check returns textual match results rather than a personal-information profile.
Nigeria	Voter ID`VOTER_ID`	Country, ID type and number, Full name, Year of birth, Photograph, Phone number, Gender, Address, Structured address	The date-of-birth field contains the year only for this check.
Zambia	Bank Account`BANK_ACCOUNT`	Country, ID type and account number, Account holder full name, Phone number	Availability follows the issuing source record.
Zambia	TPIN`TPIN`	Country, ID type and number, Full name	No date of birth, photograph, phone number, document image, gender or address is returned.
Zimbabwe	National ID (No Photo)`NATIONAL_ID_NO_PHOTO`	Country, ID type and number, First name, Last name, Full name, Date of birth, Gender, Alive status	No photograph, address, phone number or document image is returned.

Bank Account Codes

For BANK_ACCOUNT checks, include a supported bank_code for the selected country.

NG

044 (Access Bank), 063 (Access Bank (Diamond Bank)), 050 (Ecobank), 084 (Enterprise Bank), 070 (Fidelity Bank), 011 (First Bank), 214 (FCMB), 058 (GTBank), 301 (Jaiz Bank), 082 (Keystone Bank), 014 (Mainstreet Bank), 076 (Polaris Bank), 221 (Stanbic IBTC), 232 (Sterling Bank), 032 (Union Bank), 033 (UBA), 215 (Unity Bank), 035 (Wema Bank)

ZM

543 (543), absa (Absa Bank), accessbank (Access Bank), airtel (Airtel), atma (Atlas Mara), boc (Bank of China), citibank (Citibank), ecobank (Ecobank), etumba (eTumba), indo (Indo Zambia), investrust (Investrust Bank), fab (First Alliance), firstcapital (First Capital), fnb (FBN), mtn (MTN), stanbic (Stanbic Bank), stanchart (Standard Chartered), tenga (Tenga), uba (UBA), zanaco (Zanaco), zamtel (Zamtel), zicb (ZICB), zoona (Zoona)