API Documentation



Authorization: Bearer YOUR_API_TOKEN



API Endpoints

NIN WITH NIN

NIN number only for this verification

NIN Verification
POST
https://api.ninslip.com/nin/
Description

This API allows you to verify NIN Number.

Headers
Key Value
Authorization Bearer YOUR_API_TOKEN
Content-Type application/json
Request Body
{ "number": "12345678901" }
Successful Response Example
{ "status": "success", "reportID": "280325-31AA4C4B87DC7A", "message": "ID Verified Successfully", "data": { "firstname": "EXAMPLE_FIRSTNAME", "middlename": "EXAMPLE_MIDDLENAME", "surname": "EXAMPLE_SURNAME", "telephoneno": "08012345678", "residence_state": "EXAMPLE_RESIDENT_STATE", "residence_town": "EXAMPLE_TOWN", "residence_address": "EXAMPLE_ADDRESS", "residence_lga": "EXAMPLE_LGA", "birthcountry": "EXAMPLE_COUNTRY", "birthstate": "EXAMPLE_STATE", "birthlga": "EXAMPLE_LGA", "gender": "EXAMPLE_GENDER", "nin": "12345678901", "birthdate": "1990-01-01", "photo": "EXAMPLE_BASE64_IMAGE_STRING" } }

Test This API

Response:

NIN WITH PHONE

Phone number only for this verification

Phone NIN Verification
POST
https://api.ninslip.com/phone/
Description

This API allows you to verify Phone Number.

Headers
Key Value
Authorization Bearer YOUR_API_TOKEN
Content-Type application/json
Request Body
{ "number": "12345678901" }
Successful Response Example
{ "status": "success", "reportID": "280325-31AA4C4B87DC7A", "message": "ID Verified Successfully", "data": { "firstname": "EXAMPLE_FIRSTNAME", "middlename": "EXAMPLE_MIDDLENAME", "surname": "EXAMPLE_SURNAME", "telephoneno": "08012345678", "residence_state": "EXAMPLE_RESIDENT_STATE", "residence_town": "EXAMPLE_TOWN", "residence_address": "EXAMPLE_ADDRESS", "residence_lga": "EXAMPLE_LGA", "birthcountry": "EXAMPLE_COUNTRY", "birthstate": "EXAMPLE_STATE", "birthlga": "EXAMPLE_LGA", "gender": "EXAMPLE_GENDER", "nin": "12345678901", "birthdate": "1990-01-01", "photo": "EXAMPLE_BASE64_IMAGE_STRING" } }

Test This API

Response:

NIN WITH TRACKING ID

NIN Tracking ID only for this verification

NIN Tracking-ID Verification
POST
https://api.ninslip.com/tracking-id/
Description

This API allows you to verify Tracking-ID.

Headers
Key Value
Authorization Bearer YOUR_API_TOKEN
Content-Type application/json
Request Body
{ "number": "12345678901" }
Successful Response Example
{ "status": "success", "reportID": "280325-31AA4C4B87DC7A", "message": "ID Verified Successfully", "data": { "firstname": "EXAMPLE_FIRSTNAME", "middlename": "EXAMPLE_MIDDLENAME", "surname": "EXAMPLE_SURNAME", "telephoneno": "08012345678", "residence_state": "EXAMPLE_RESIDENT_STATE", "residence_town": "EXAMPLE_TOWN", "residence_address": "EXAMPLE_ADDRESS", "residence_lga": "EXAMPLE_LGA", "birthcountry": "EXAMPLE_COUNTRY", "birthstate": "EXAMPLE_STATE", "birthlga": "EXAMPLE_LGA", "gender": "EXAMPLE_GENDER", "nin": "12345678901", "birthdate": "1990-01-01", "photo": "EXAMPLE_BASE64_IMAGE_STRING" } }

Test This API

Response:

BVN VERIFICATION

BVN number only for this verification

BVN Verification
POST
https://api.ninslip.com/bvn/
Description

This API allows you to verify BVN.

Headers
Key Value
Authorization Bearer YOUR_API_TOKEN
Content-Type application/json
Request Body
{ "number": "12345678901" }
Successful Response Example
{ "status": "success", "reportID": "280325-31AA4C4B87DC7A", "message": "ID Verified Successfully", "data": { "firstname": "EXAMPLE_FIRSTNAME", "middlename": "EXAMPLE_MIDDLENAME", "surname": "EXAMPLE_SURNAME", "telephoneno": "08012345678", "residence_state": "EXAMPLE_RESIDENT_STATE", "residence_town": "EXAMPLE_TOWN", "residence_address": "EXAMPLE_ADDRESS", "residence_lga": "EXAMPLE_LGA", "birthcountry": "EXAMPLE_COUNTRY", "birthstate": "EXAMPLE_STATE", "birthlga": "EXAMPLE_LGA", "gender": "EXAMPLE_GENDER", "nin": "12345678901", "birthdate": "1990-01-01", "photo": "EXAMPLE_BASE64_IMAGE_STRING" } }

Test This API

Response:

USER PROFILE

User profile and account information

Get Balance
GET
https://api.ninslip.com/getbalance/
Description

Retrieve your current account balance.

Headers
Key Value
Authorization Bearer YOUR_API_TOKEN
Successful Response Example
{ "status": "success", "user_id": 13, "balance": "8500.00" }

Test This API

Response:

Variables

Variable Default Value
base_url https://api.ninslip.com
api_token YOUR_API_TOKEN