Managing Verifications
Retrieve a specific verification result or list all verifications for your organization using the Lira API.
Get a verification by ID
Use this to poll for the result of an async verification or to look up a past verification.
curl https://api.lira.com/api/v1/verify/VERIFICATION_ID \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"id": "ver_a1b2c3d4-...",
"organizationId": "org_...",
"type": "ACCOUNT_NUMBER",
"identifier": "0123456789",
"status": "success",
"mode": "sync",
"providerName": "nibss",
"source": "provider",
"createdAt": "2026-03-09T10:05:00.000Z",
"updatedAt": "2026-03-09T10:05:01.000Z"
}
List verifications
Return all verifications for your organization. Supports filtering by type, status, and pagination.
curl "https://api.lira.com/api/v1/verify?type=ACCOUNT_NUMBER&status=success&limit=20" \
-H "X-API-Key: YOUR_API_KEY"
Query parameters
| Parameter | Type | Description |
|---|---|---|
type |
string | Filter by type: ACCOUNT_NUMBER, PHONE_NUMBER, BVN |
status |
string | Filter by status: success, failed, error, pending |
limit |
integer | Max results to return (default 50, max 100) |
offset |
integer | Pagination offset (default 0) |
Response fields
| Field | Description |
|---|---|
id |
Unique verification ID |
organizationId |
Your organization's ID |
type |
Verification type |
identifier |
The submitted account number, phone number, or identity number |
status |
success, failed, error, or pending |
mode |
sync or async |
source |
provider (fresh query) or cache (cached result) |
createdAt |
When the verification was submitted |
updatedAt |
When the status was last updated |
Next steps
- Async Verification — receive results via webhook instead of polling
- Errors — full error code reference
