Test Data

Test out your ID API integration without using up credits or real ID numbers

In the Sandbox environment you are provided a limited number of ID validation credits that you can use to test real ID numbers before moving into Production. Below we also provide ID test data that allows you to run an unlimited number of tests without using up credits or real ID numbers. The test ID data is flexible. The ID data format matches each id_type’s true corresponding format, but the final digit determines what response is received.

Country

id_type

Format

Ghana

DRIVERS_LICENSE

*B0000000

Ghana

PASSPORT

*G0000000

Ghana

SSNIT

*C000000000000

Ghana

VOTER_ID

0000000000

Kenya

ALIEN_CARD

000000

Kenya

NATIONAL_ID

00000000

Kenya

PASSPORT

A00000000

Nigeria

BVN

00000000000

Nigeria

NIN

00000000000

Nigeria

PASSPORT

Nigeria

DRIVERS_LICENSE

Nigeria

VOTER_ID

Nigeria

NATIONAL_ID

Nigeria

TIN

Nigeria

CAC

* Letter prefix - for example "C" prior to number format

To test various outcomes, change the final digit of the id_number to attain the desired outcome. There are four Simulated Results to test in your integration.

Final Digit

Simulated Result

0

Success w/ correct meta-data return

1

Failure, no record found

2

Success w/ incorrect meta-data return

3

Database unavailable/unknown network issue

Note: not all possible outcomes are included in these Simulated Results — For example, using an ID from a country we don’t support would result in an "Unsupported ID Type and/or Country” result. A full list of possible ID API result codes can be found below and in the Result Codes section.

ID Validation Result Codes:

Code

Description

1012

Success

1013

Invalid ID

1014

Unsupported ID Type and/or Country

1015

Error - Queried Database Unavailable

1016

Product Activation Required