Skip to main content
POST
/
api
/
onboarding
/
nigeria_kyc
/
address_verification
Address Verification
curl --request POST \
  --url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/address_verification/ \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "phone_number": "<string>",
  "address": "<string>",
  "lga": "<string>",
  "state": "<string>"
}
'
{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.smartcomply.com/llms.txt

Use this file to discover all available pages before exploring further.

The Address Verification endpoint initiates a verification of a customer’s residential address. It cross-references the provided details against identity records and returns an initial verification status with a reference ID for tracking.
Address verification is asynchronous. You will receive a reference in the response — use the webhook or the Digital Address Confirmation endpoint to get the final result.

​
Endpoint

POST /api/onboarding/nigeria_kyc/address_verification/

​
Request

​
Headers

HeaderValueRequired
x-access-tokenYour API secret keyYes
Content-Typeapplication/jsonYes

​
Body Parameters

ParameterTypeRequiredDescription
first_namestringYesCustomer’s first name
last_namestringYesCustomer’s last name
ninstringYesCustomer’s 11-digit NIN
phone_numberstringYesCustomer’s phone number
birth_datestringYesDate of birth (format: DD/MM/YYYY)
streetstringYesFull street address
citystringYesCity
lgastringYesLocal government area
statestringYesState
landmarkstringNoNearby landmark to aid verification

​
Example

curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/address_verification/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John", "last_name": "Doe",
    "nin": "10000000001", "phone_number": "08000000000",
    "birth_date": "17/01/1988",
    "street": "270 Murtala Muhammed Way, Alagomeji. Yaba",
    "city": "oshodi", "lga": "lagos mainland",
    "state": "Lagos", "landmark": "lagos"
  }'

​
Response

​
200 OK

FieldTypeDescription
data.idintegerVerification record ID
data.referencestringUnique reference for tracking the verification
data.status.statusstringCurrent verification status (e.g., "In Progress")
data.applicantobjectSubmitted applicant details
data.lattitudestringGeocoded latitude of the address
data.longitudestringGeocoded longitude of the address
data.photosarrayPhotos captured during field verification
data.neighborobjectNeighbor confirmation details (if completed)
{
  "status": "success",
  "data": {
    "id": 1,
    "applicant": {
      "firstname": "John",
      "lastname": "Doe",
      "phone": "08000000000",
      "idType": "nin",
      "idNumber": "10000000001",
      "gender": "Male",
      "birthdate": "17/01/1988"
    },
    "createdAt": "",
    "completedAt": "",
    "lattitude": "9.081999",
    "longitude": "8.675277",
    "photos": [],
    "neighbor": {
      "name": "Tunde Adetunji",
      "comment": "Very friendly",
      "phone": "080900000000"
    },
    "status": {
      "status": "In Progress",
      "subStatus": "In Progress",
      "state": "In Progress"
    },
    "city": "oshodi",
    "street": "270 Murtala Muhammed Way, Alagomeji. Yaba",
    "lga": "lagos mainland",
    "state": "Lagos",
    "country": "Nigeria",
    "reference": "1732800207805106"
  }
}

​
400 Bad Request

{
  "status": "failed",
  "data": [],
  "message": "Missing required fields"
}

​
401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}

Authorizations

​
x-access-token
string
header
required

Your Adhere API secret key

Body

application/json
​
first_name
string
required
​
last_name
string
required
​
phone_number
string
required
​
address
string
required
​
lga
string
required

Local Government Area

​
state
string
required

Response

Address verification submitted