Submit a verification request for background processing.
Flow:
- Submit verification request
- Receive verification_id immediately
- Check status using GET /api/v1/verification/async/status/{verification_id}/
- Receive webhook notification when complete (if webhook_url configured)
Benefits:
- No waiting for gateway response
- Can handle slow gateway responses
- Higher throughput
- Automatic retries on failure
Authorization
ApiKeyAuth In: header
Path Parameters
TypeScript Definitions
Use the request body type in TypeScript.
Serializer for async verification requests.
Response Body
application/json
curl -X POST "https://example.com/api/v1/verification/async/string/" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "status": true, "message": "string", "data": { "verification_id": "5bcbf7ac-c998-46ce-aa6e-a0c1a3f1f5bd", "status": "pending", "channel_code": "string", "created_at": "2019-08-24T14:15:22Z", "estimated_completion": "string" } }, "status": true, "message": "Request successful.", "errors": {}, "meta": { "timestamp": "2019-08-24T14:15:22Z", "version": "v1", "request_id": "string" }, "pagination": { "page": 0, "page_size": 0, "total_pages": 0, "total_items": 0 }}response_code values (e.g., 00 Success, 01 Not Found, 02 Unavailable).Join our developer Slack channel for real-time integration support, engineering updates, and direct Q&A with the Prembly team.
Join Slack ChannelList verification request logs GET
Get a paginated list of all verification requests with filtering, sorting, and search capabilities. Returns logs for the authenticated user's organization.
Check async verification status GET
Check the status of an asynchronous verification request. **Statuses:** - `pending`: Request queued, waiting to be processed - `processing`: Currently being processed - `success`: Completed successfully - `failed`: Verification failed (invalid data, etc.) - `error`: System error occurred **Polling:** - Poll every 2-5 seconds until status is not 'pending' or 'processing' - Maximum processing time: 30 seconds