Skip to main content

​
Prerequisites

Before you start, make sure you have:
  • A Smartcomply account — sign up here
  • Completed your business KYC on the Adhere dashboard
  • Generated a secret key under Settings → API Keys

​
Make Your First Request

The example below verifies a Nigerian BVN. Replace YOUR_SECRET_KEY with your actual key. 
curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/bvn/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bvn": "22000000001"}'

​
Successful Response

{
  "status": "success",
  "data": {
    "lastName": "OMOLE",
    "firstName": "ABRAHAM",
    "middleName": "ISAAC",
    "dateOfBirth": "1909-09-19",
    "phoneNumber1": "09011001100"
  },
  "message": "Bank Verification Number details retrieved successfully"
}
If you receive a 401, check that your x-access-token header is set correctly. For a full list of error responses, see Error Codes.

​
Next Steps

Authentication

Learn how to secure and manage your API keys.

KYC Endpoints

Explore all identity verification endpoints.

Error Codes

Understand all possible error responses.

Webhooks

Set up real-time event notifications.