Prembly
GuidesAPI Reference
Verification LogsAsyncCheck async verification status GET
GET
/api/v1/verification/async/status/{verification_id}/

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

Authorization

ApiKeyAuth
X-API-Key<token>

In: header

Path Parameters

verification_id*string
Formatuuid

Response Body

application/json

curl -X GET "https://example.com/api/v1/verification/async/status/497f6eca-6276-4993-bfeb-53cbbbba6f08/"
{  "data": {    "verification_id": "5bcbf7ac-c998-46ce-aa6e-a0c1a3f1f5bd",    "status": "pending",    "channel_code": "string",    "channel_name": "string",    "response_code": "string",    "response_summary": "string",    "amount_charged": "string",    "currency": "string",    "created_at": "2019-08-24T14:15:22Z",    "completed_at": "2019-08-24T14:15:22Z",    "response_data": null  },  "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 Codes & Statuses: Prembly API responses include custom response_code values (e.g., 00 Success, 01 Not Found, 02 Unavailable).
View Response Codes Guide
Prembly Slack Community

Join our developer Slack channel for real-time integration support, engineering updates, and direct Q&A with the Prembly team.

Join Slack Channel

Submit async verification request POST

Submit a verification request for background processing. **Flow:** 1. Submit verification request 2. Receive verification_id immediately 3. Check status using GET /api/v1/verification/async/status/{verification_id}/ 4. 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

List verification sessions GET

Retrieve a paginated list of all SDK verification sessions for the authenticated organization. **Features:** - Lightweight data for fast performance (no full verification data) - Paginated results (default: 20 per page) - Ordered by creation date (newest first) - Includes basic session information only **For Full Details:** Use GET /sessions/{session_id}/report/ to get comprehensive verification data **Filtering:** - Filter by status: ?status=completed - Search by email: ?email=user@example.com - Search by session_id: ?session_id=xxx