Get a NIN lookup
curl --request GET \
--url https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"object": "nin_lookup",
"id": "ninl_6x9CKdEGQkJAbby8D1u7kN",
"nin": "12345678901",
"first_name": "ADA",
"middle_name": "CHIOMA",
"last_name": "OBI",
"gender": "female",
"date_of_birth": "1990-04-12",
"phone": "08031234567",
"address": "12 ADMIRALTY WAY, LEKKI, LAGOS",
"photo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABA…",
"nimc_data": {},
"amount_charged": "100.00",
"transaction_id": "wtx_0hA6wRH6yeYHTLfRjK4Bxn",
"created_at": "2026-10-26T05:55:58Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"type": "authentication_error",
"code": "api_key_missing",
"message": "Send your API key as `Authorization: Bearer <key>`.",
"param": null,
"request_id": "req_hXO9uf6JYXxTYMz20Du2lF8n"
}
}{
"error": {
"type": "permission_error",
"code": "live_mode_unavailable",
"message": "Live registrations are paused right now. Use a test key (fc_test_…) meanwhile.",
"param": null,
"request_id": "req_gXc3KKfa1egcBqGIxApcVRIr"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such registration: reg_0000000000000000000000.",
"param": "id",
"request_id": "req_5pBegFvIypCQp0ZmlXajiiet"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}Identities
Get a NIN lookup
A lookup you made in this mode, again. Free.
GET
/
identities
/
nin_lookups
/
{nin_lookup_id}
Get a NIN lookup
curl --request GET \
--url https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fastcac.com/v1/identities/nin_lookups/{nin_lookup_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"object": "nin_lookup",
"id": "ninl_6x9CKdEGQkJAbby8D1u7kN",
"nin": "12345678901",
"first_name": "ADA",
"middle_name": "CHIOMA",
"last_name": "OBI",
"gender": "female",
"date_of_birth": "1990-04-12",
"phone": "08031234567",
"address": "12 ADMIRALTY WAY, LEKKI, LAGOS",
"photo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABA…",
"nimc_data": {},
"amount_charged": "100.00",
"transaction_id": "wtx_0hA6wRH6yeYHTLfRjK4Bxn",
"created_at": "2026-10-26T05:55:58Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"type": "authentication_error",
"code": "api_key_missing",
"message": "Send your API key as `Authorization: Bearer <key>`.",
"param": null,
"request_id": "req_hXO9uf6JYXxTYMz20Du2lF8n"
}
}{
"error": {
"type": "permission_error",
"code": "live_mode_unavailable",
"message": "Live registrations are paused right now. Use a test key (fc_test_…) meanwhile.",
"param": null,
"request_id": "req_gXc3KKfa1egcBqGIxApcVRIr"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such registration: reg_0000000000000000000000.",
"param": "id",
"request_id": "req_5pBegFvIypCQp0ZmlXajiiet"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>",
"details": {}
}
}Authorizations
Your secret API key: fc_test_… in test mode, fc_live_… in live mode.
Path Parameters
Response
Successful Response
ninl_…: pass it as a proprietor's nin_lookup, or to use the photo as the passport.
As NIMC holds it (usually upper case).
Goes in the proprietor's other_names.
Available options:
male, female YYYY-MM-DD.
NIMC's residence address as one line; the registration takes it in parts.
NIMC's photo as a data: URI (JPEG).
Every other field NIMC returned, as it came.
What the lookup cost, in naira, as a decimal string.
The wtx_… nin_lookup_charge.
Allowed value:
"nin_lookup"