Developer Documentation
A unified REST API for identity, biometric, business, and telecom verification — designed for fintechs, marketplaces, telecom, and regulated SaaS.
KYC.bd is a modular verification stack for Bangladesh and emerging markets. Each module exposes a focused REST endpoint over HTTPS with JSON payloads.
National ID workflows with consent capture.
Selfie-to-document biometric comparison & liveness.
Company registration, TIN, and merchant checks.
SIM ownership and operator validation.
Real-time event delivery for verification lifecycle.
Rate limits, audit logs, and unified auth.
All requests require a Bearer API key in the Authorization header.
Authorization: Bearer YOUR_API_KEY{
"full_name": "John Doe",
"date_of_birth": "1998-05-15",
"national_id": "1234567890",
"mobile": "+8801XXXXXXXXX",
"consent": true,
"reference_id": "USER-1001"
}{
"status": "verified",
"verification_id": "KYC-8472931",
"match_score": 98.7,
"risk_level": "low",
"timestamp": "2026-05-07T12:00:00Z"
}curl -X POST https://api.kyc.bd/v1/identity/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"full_name":"John Doe",
"date_of_birth":"1998-05-15",
"national_id":"1234567890",
"mobile":"+8801XXXXXXXXX",
"consent":true
}'{
"document_image": "base64_encoded_image",
"selfie_image": "base64_encoded_image",
"reference_id": "USER-1001"
}{
"status": "matched",
"confidence_score": 96.4,
"liveness": true,
"fraud_risk": "low"
}{
"company_name": "Example Technologies Ltd",
"registration_number": "C-123456",
"tin": "987654321",
"contact_email": "admin@example.com"
}{
"status": "verified",
"company_status": "active",
"risk_level": "medium",
"verification_id": "BIZ-82711"
}{
"mobile_verified": true,
"operator": "Detected Operator",
"sim_status": "active",
"risk_score": 12
}KYC.bd delivers real-time events via signed webhook callbacks. Configure your endpoint URL and signing secret in the dashboard.
| Event | Description |
|---|---|
| verification.completed | Verification finished |
| verification.failed | Verification rejected |
| aml.flagged | AML or sanctions alert |
| consent.revoked | Consent withdrawn |
| fraud.detected | Suspicious activity identified |
{
"event": "verification.completed",
"verification_id": "KYC-8472931",
"status": "verified",
"timestamp": "2026-05-07T12:00:00Z"
}Official client libraries with typed methods and built-in retries.