List Verifications
List previous citizen verification requests for your business account.
Purpose
List previous citizen verification requests for your business account.
Endpoint group cards
Detailed endpoint
/api/v1/verificationsList verifications
List previous verification requests.
Real-time
Under 2 seconds
Requires API Key
Bearer token
Rate Limit
60 req/min
Credits
1 credit per request
Overview
List previous verification requests. This endpoint is designed for secure server-to-server integrations and returns structured JSON suitable for enterprise audit, reporting, and ERP reconciliation.
Requires API key authentication
Send requests from a trusted backend using Authorization: Bearer <api_key>. Never expose live API keys in frontend code.
Rate limit: 60 requests per minute
Use idempotency keys and exponential backoff. Retry only after the reset window or the Retry-After header.
Request
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| page | integer | optional | Page number (default 1). | 1 |
| limit | integer | optional | Page size, max 100 (default 20). | 20 |
| Authorization | header | required | Bearer API key. | Bearer xq_test_xxxxxxxxxxxxxx |
// GET request — optional query: ?page=1&limit=20Response
{ "message": "Verifications retrieved successfully", "data": [ { "id": "uuid", "result": "verified", "purpose": "pre_employment", "channel": "api", "createdAt": "2026-06-02T12:30:00.000Z" } ], "pagination": { "page": 1, "limit": 20, "total": 1 }}Code Examples
curl -X GET "http://localhost:8080/api/v1/verifications" \ -H "Authorization: Bearer xq_test_xxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: verify-2026-06-02-001" \ -d '// GET request — optional query: ?page=1&limit=20'Errors
{ "status": "failed", "code": "BAD_REQUEST", "message": "Validation failed", "errors": [ { "field": "nationalId", "message": "National ID must be exactly 11 digits" } ]}| HTTP status | Error code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Malformed request or validation failure. |
| 401 | UNAUTHORIZED | Missing, invalid, revoked, or expired API key. |
| 403 | FORBIDDEN | Business inactive or not on an enterprise plan. |
| 404 | NOT_FOUND | Resource not found. |
| 409 | CONFLICT | Idempotency-Key reused with a different payload. |
| 429 | RATE_LIMITED | Too many requests — retry with backoff. |
| 500 | INTERNAL_ERROR | Unexpected server error. |
Rate Limits
Rate limit: 60 requests per minute
Use idempotency keys and exponential backoff. Retry only after the reset window or the Retry-After header.