POST
/
kyc
/
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": []
}