APIs built for digital trust teams
Use REST APIs, scoped keys, webhooks, audit logs and predictable JSON responses to embed Identro verification directly into your product.
Production-ready API layer
REST, keys, webhooks and audit trail.
Scoped API keys
Create keys per merchant, expire them when needed and restrict usage to approved services.
Webhooks
Receive request lifecycle updates for verification, manual workflows and transaction events.
Consent-first verification
Send consent references with every request and keep payloads tied to auditable activity.
Operational visibility
Track API activity, wallet deductions and service status from the same workspace.
Quick start
Integrate verification without rebuilding compliance flows
Identro gives developers a clean API surface for identity checks, biometric liveness, business verification and wallet-backed service execution.
Create account
Register, verify email and complete the required onboarding flow.
Generate API key
Create a scoped key from the merchant dashboard with an optional expiry date.
Call services
Use the REST endpoint for NIN, BVN, CAC/TIN, face, address or digital services.
Receive results
Get predictable JSON responses and listen for webhooks where the service is asynchronous.
01curl -X POST https://api.identro.ng/api/v1/merchant-api/nin/verify \02 -H "x-api-key: $IDENTRO_API_KEY" \03 -H "Content-Type: application/json" \04 -d '{"nin":"12345678901","consentCaptured":true,"consentReference":"APP-CONSENT-001"}'01{02 "success": true,03 "code": "SUCCESS",04 "message": "Request successful",05 "data": {06 "nin": "12345678901",07 "gender": "Male",08 "lastName": "OYENUGA",09 "firstName": "KEHINDE",10 "middleName": "",11 "dateOfBirth": "1992-04-02",12 "phoneNumber": "09039362222",13 "email": "customer@example.com",14 "address": "12 Example Street, Abuja",15 "state": "FCT",16 "lga": "AMAC",17 "stateOfOrigin": "Kano",18 "lgaOfOrigin": "Kabo",19 "residentialAddress": "12 Example Street, Abuja",20 "photo": "base64-image-from-verification-source"21 }22}REST endpoints
Simple HTTPS endpoints for verification and service requests.
Clean payloads
Stable JSON contracts designed for backend and mobile teams.
Secure lifecycle
Disable, rotate, terminate or expire keys from the dashboard.
Documentation
Start with the full API documentation
Review endpoint examples, authentication requirements, consent fields and webhook behaviour before going live.