curl --request POST \
  --url https://api.sendpadi.com/api/v1/merchant/identity/nin/enhanced \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>' \
  --data '
{
  "nin": "22222222222"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Timestamp': '<x-timestamp>',
    'X-Signature': '<x-signature>',
    'Idempotency-Key': '<idempotency-key>',
    'X-Api-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({nin: '22222222222'})
};

fetch('https://api.sendpadi.com/api/v1/merchant/identity/nin/enhanced', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sendpadi.com/api/v1/merchant/identity/nin/enhanced"

payload = { "nin": "22222222222" }
headers = {
    "X-Timestamp": "<x-timestamp>",
    "X-Signature": "<x-signature>",
    "Idempotency-Key": "<idempotency-key>",
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "transactionId": "idv_txn_001",
    "reference": "IDV-abc",
    "status": "completed",
    "product": "nin_enhanced",
    "idType": "nin",
    "level": "enhanced",
    "charge": {
      "amount": 100,
      "currency": "NGN"
    },
    "lookupType": "record",
    "record": {
      "idNumber": "22222222222",
      "firstName": "John",
      "middleName": "Michael",
      "lastName": "Doe",
      "fullName": "John Michael Doe",
      "gender": "Male",
      "dateOfBirth": "1990-01-01",
      "phoneNumber": "08012345678",
      "photo": "<base64>",
      "email": "john.doe@example.com",
      "address": "1 Example Street, Ikeja, Lagos",
      "stateOfOrigin": "Lagos",
      "nationality": "Nigeria"
    },
    "match": null
  }
}

{
  "success": false,
  "message": "Insufficient funds. NIN costs 70 NGN; your available balance is 0 NGN.",
  "error": "INSUFFICIENT_BALANCE"
}

{
  "success": false,
  "message": "No record was found for this NIN. The lookup was completed and has been charged.",
  "error": "IDENTITY_NOT_FOUND",
  "data": {
    "transactionId": "idv_txn_001",
    "reference": "IDV-abc",
    "status": "completed",
    "refunded": false,
    "charge": {
      "amount": 70,
      "currency": "NGN"
    }
  }
}

{
  "success": false,
  "message": "NIN verification is temporarily unavailable. Please try again shortly. You have not been charged.",
  "error": "IDENTITY_PROVIDER_UNAVAILABLE",
  "data": {
    "transactionId": "idv_txn_001",
    "reference": "IDV-abc",
    "status": "failed",
    "refunded": true,
    "charge": {
      "amount": 70,
      "currency": "NGN"
    }
  }
}