POST
/
kyc
/
validate
/
nin
Validate NIN
curl --request POST \
  --url https://devapi.withedge.co/gateway/api/v1/kyc/validate/nin \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'requestId: <requestid>' \
  --data '{
  "nin": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "otherName": "<string>",
  "dob": "<string>"
}'
{
	"statusCode": 00,
	"message": "Completed successfully"
	"data": {},
	"errors": []
}

Validate NIN

Use this endpoint to validate a customer’s National Identity Number (NIN) along with their personal details.

Request Parameters

requestId
string
required
A unique identifier for the request, used for idempotency.
Example: e0b9f8d0-7a57-4a67-a8b2-4d7c7b5a37c9
nin
string
required
The National Identity Number to be validated.
Example: 98765432101
firstName
string
required
The first name of the customer.
Example: John
lastName
string
required
The last name of the customer.
Example: Doe
otherName
string
The other names of the customer, if available.
Example: Michael
dob
string
required
The customer’s date of birth in YYYY-MM-DD format.
Example: 1990-01-01
{
	"statusCode": 00,
	"message": "Completed successfully"
	"data": {},
	"errors": []
}