Skip to main content
API Credentials Required: Before making any KYC lookup, you must have your API key and secret configured. You can retrieve your credentials from the API & Webhook settings page.

​
The KYC Flow

Running a KYC lookup in Sigma is straightforward: 1. Get Your API Credentials Retrieve your apiKey and apiSecret from My Account → API & Webhooks in the Sigma dashboard. These headers are required on every request. See how to get your API credentials → 2. Choose a Lookup Type Sigma KYC supports three lookup types depending on what you need to verify:
LookupEndpointWhen to use
BVN SearchPOST /api/v1/kyc/bvnVerify an individual using their Bank Verification Number
NIN SearchPOST /api/v1/kyc/ninVerify an individual using their National Identification Number
CAC SearchPOST /api/v1/kyc/cacVerify a business using its CAC registration number
3. Send the Request Make a POST request to the appropriate endpoint with the required payload. For BVN and NIN, send the idNumber field. For CAC, send the rcNumber, companyName, and companyType fields. 4. Parse the Response The API returns verified data from government databases including personal details, contact information, photos, and (for CAC) affiliated persons such as directors and shareholders.

​
Authentication

All KYC requests require two custom headers:
HeaderDescription
apiKeyYour API key
apiSecretYour API secret
const headers = {
  apiKey: "your-api-key-here",
  apiSecret: "your-api-secret-here",
};

​
Environments

KYC is available in both sandbox and production environments. The sandbox returns static responses for testing at no cost. Production performs real lookups and consumes wallet balance. See the Environments page for base URLs.

​
Prerequisites

Before making your first KYC lookup, make sure you have:
  • An active Sigma account
  • API key and secret configured in API & Webhook settings
  • Wallet balance loaded (for production requests)

BVN Search

Look up individual identity using a BVN.

NIN Search

Look up individual identity using a NIN.

CAC Search

Look up business registration using a CAC number.