NIN Verification
curl --request POST \
--url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/ \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"identification_number": "70123456789"
}
'import requests
url = "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/"
payload = { "identification_number": "70123456789" }
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({identification_number: '70123456789'})
};
fetch('https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identification_number' => '70123456789'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/"
payload := strings.NewReader("{\n \"identification_number\": \"70123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identification_number\": \"70123456789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identification_number\": \"70123456789\"\n}"
response = http.request(request)
puts response.read_body{
"status": "failed",
"data": [
"<unknown>"
],
"message": "<string>"
}{
"status": "failed",
"message": "Authentication credentials were not provided."
}Nigeria
Numéro National d'Identité (NIN)
Vérifiez l’identité d’un client à l’aide de son Numéro National d’Identification à 11 chiffres.
POST
/
api
/
onboarding
/
nigeria_kyc
/
nin
/
NIN Verification
curl --request POST \
--url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/ \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"identification_number": "70123456789"
}
'import requests
url = "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/"
payload = { "identification_number": "70123456789" }
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({identification_number: '70123456789'})
};
fetch('https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identification_number' => '70123456789'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/"
payload := strings.NewReader("{\n \"identification_number\": \"70123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identification_number\": \"70123456789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identification_number\": \"70123456789\"\n}"
response = http.request(request)
puts response.read_body{
"status": "failed",
"data": [
"<unknown>"
],
"message": "<string>"
}{
"status": "failed",
"message": "Authentication credentials were not provided."
}L’endpoint NIN récupère les données d’identité vérifiées d’un client depuis la base de données de la National Identity Management Commission (NIMC). Il renvoie des détails personnels complets incluant les données biographiques, les informations de contact de proche et une photo du client.
Endpoint
POST /api/onboarding/nigeria_kyc/nin/
Requête
En-têtes
| En-tête | Valeur | Requis |
|---|---|---|
x-access-token | Votre clé secrète API | Oui |
Content-Type | application/json | Oui |
Paramètres de corps
| Paramètre | Type | Requis | Description |
|---|---|---|---|
identification_number | string | Oui | Le Numéro National d’Identification à 11 chiffres du client |
Exemple
curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/" \
-H "x-access-token: YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"identification_number": "70123456789"}'
const response = await fetch(
"https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/",
{
method: "POST",
headers: {
"x-access-token": "YOUR_SECRET_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ identification_number: "70123456789" }),
}
);
const data = await response.json();
import requests
response = requests.post(
"https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nin/",
headers={
"x-access-token": "YOUR_SECRET_KEY",
"Content-Type": "application/json",
},
json={"identification_number": "70123456789"},
)
data = response.json()
Réponse
200 OK
| Champ | Type | Description |
|---|---|---|
data.nin | string | Le NIN qui a été interrogé |
data.firstName | string | Prénom |
data.middleName | string | Deuxième prénom |
data.lastName | string | Nom de famille |
data.gender | string | "male" ou "female" |
data.dateOfBirth | string | Date de naissance au format YYYY-MM-DD |
data.birthState | string | État de naissance |
data.birthLga | string | Zone de gouvernement local de naissance |
data.telephoneNo | string | Numéro de téléphone enregistré |
data.email | string | null | Adresse e-mail (si disponible) |
data.residenceAddress | string | Adresse de résidence actuelle |
data.residenceState | string | État de résidence |
data.residenceLga | string | Zone de gouvernement local de résidence |
data.residenceTown | string | Ville de résidence |
data.maritalStatus | string | Par ex. "single", "married", "separated" |
data.educationalLevel | string | Niveau d’éducation le plus élevé |
data.employmentStatus | string | Par ex. "employed", "unemployed" |
data.religion | string | Religion |
data.spokenLanguage | string | Langue principale parlée |
data.height | string | Taille en centimètres |
data.profession | string | Profession déclarée |
data.nokFirstname | string | Prénom du contact de proche |
data.nokSurname | string | Nom de famille du contact de proche |
data.nokAddress1 | string | Adresse du contact de proche |
data.nokState | string | État du contact de proche |
data.nokLga | string | Zone de gouvernement local du contact de proche |
data.image | string | Photo du client encodée en base64 |
data.trackingId | string | Référence de suivi NIMC |
{
"status": "success",
"data": {
"title": "mr",
"lastName": "DOE",
"firstName": "JOHN",
"middleName": "JOSEPH",
"gender": "male",
"dateOfBirth": "2000-10-21",
"birthLga": "Olamaboro",
"birthState": "Kogi",
"centralID": "",
"educationalLevel": "secondary",
"email": null,
"nin": "12345678901",
"employmentStatus": "unemployed",
"height": "180",
"maritalStatus": "separated",
"religion": "christianity",
"telephoneNo": "08050003000",
"residenceAddress": "MR SNUFUSS'S HOUSE SNUFUSS STREET PHASE 3",
"residenceLga": "Gwagwalada",
"residenceState": "FCT Abuja",
"residenceTown": "GWAGWALADA",
"nokFirstname": "JOHN",
"nokSurname": "DOE",
"nokAddress1": "NO 6 ADUM ROAD OGUGU CENTRE",
"nokState": "Kogi",
"nokLga": "Olamaboro",
"profession": "STUDENT",
"spokenLanguage": "IGALA",
"trackingId": "S2R0NYFO01113TR",
"image": "<base64-encoded-jpeg>"
},
"message": "National Identification Number details retrieved successfully"
}
400 Bad Request
Renvoyé lorsque le NIN est manquant, malformé ou introuvable.{
"status": "failed",
"data": [],
"message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
401 Unauthorized
{
"status": "failed",
"message": "Authentication credentials were not provided."
}

