Skip to main content
POST
https://api.fossapay.com
/
v1
/
customers
/
kyc
/
nin
Verify NIN
curl --request POST \
  --url https://api.fossapay.com/v1/customers/kyc/nin \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "nin": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "dob": "<string>"
}
'
{
  "success": true,
  "message": "NIN verification completed successfully"
}

​
Headers

​
x-api-key
string
required
API Key for authentication

​
Request Body

​
customerId
string
required
Customer ID
​
nin
string
required
National Identification Number
​
firstName
string
required
Customer’s first name
​
lastName
string
required
Customer’s last name
​
dob
string
required
Date of birth (ISO date string)

​
Request Example

curl -X POST https://api.fossapay.com/v1/customers/kyc/nin \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123456789",
    "nin": "12345678901",
    "firstName": "John",
    "lastName": "Doe",
    "dob": "1990-01-15"
  }'

const response = await fetch('https://api.fossapay.com/v1/customers/kyc/nin', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'cust_123456789',
    nin: '12345678901',
    firstName: 'John',
    lastName: 'Doe',
    dob: '1990-01-15'
  })
});

​
Response

{
  "success": true,
  "message": "NIN verification completed successfully"
}

​
Error Responses

​
Notes

  • The NIN verification process may take several seconds to complete
  • Ensure all customer details match exactly with the NIN records
  • This endpoint triggers KYC level upgrade for the customer upon successful verification