API Module
KYC Verification
Instant Aadhaar and Government ID verification API for customer onboarding and KYC compliance.
1 Endpoints
API Key Authentication
Prefix:/kyc
Jump directly to endpoint:
POST/kyc/verify
API Key Requiredmultipart/form-data
Verify User KYC
Verifies a customer identity using Aadhaar XML/OCR verification and document image inspection. Returns KYC verification status and creates or updates a verified user profile in your tenant ecosystem.
URL:https://eznotary.in/api/v1/kyc/verify
Request Parameters
Headers
| Header | Type | Required | Description |
|---|---|---|---|
| x-api-key | string | Required | Tenant API Key generated from the EZNotary B2B Developer Portal. |
| x-api-secret | string | Required | Tenant API Secret key paired with your API key. |
Request Body Parameters
Format: multipart/form-data| Field | Type | Required | Description |
|---|---|---|---|
fullName | string | Required | Full legal name matching government ID. Example: Jane Doe |
phone | string | Required | 10-digit mobile number. Example: 9876543210 |
email | string | Required | Email address of user. Example: jane.doe@example.com |
countryCode | string | Required | Country calling code. Example: 91 |
dob | string | Required | Date of birth in YYYY-MM-DD format. Example: 1990-01-01 |
gender | string | Required | Gender as per ID (Male, Female, Other). Example: Female |
hasAadhaar | string | Optional | Flag whether Aadhaar card is supplied ("true" for Aadhaar KYC, "false" for Passport KYC). Example: true |
aadhaarCard | file (binary) | Required (Either) | Image file or PDF of Aadhaar card / ID proof. Either aadhaarCard image or passport fileNumber is required. Example: aadhaar_card.jpg |
fileNumber | string | Required (Either) | Passport file number or document registration number. Either fileNumber or aadhaarCard image is required. Example: J1234567 |
cURL — Verify User KYC