Get Verification Details
Retrieve details of a specific verification request
Get Verification Details
Retrieve detailed information about a specific verification request using its unique ID.
Request Format
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The unique identifier of the verification request |
Response
Response Fields
| Field | Type | Description |
|---|---|---|
inputted_name | string | The name that was initially provided when creating the verification |
status | string | Current status of the verification (pending, completed, expired, failed) |
purpose | string | The purpose of the verification |
access_expires_at | string | ISO 8601 timestamp when the verification access for the person you want to verify themselves expires |
identified_name | string | The verified name from the identity document (null if not completed) |
identified_date | string | ISO 8601 timestamp when the verification was completed (null if not completed) |
verification_method | string | The method used for verification (e.g., itsme, idin,passport, id_card, drivers_license) |
failed_reason | string | Reason for failure if status is failed, otherwise null |
kept_until | string | ISO 8601 timestamp indicating how long the verification data will be retained for you |
Example Request
Verification Status
The status field can have one of the following values:
pending- Verification request has been sent but not yet completedcompleted- Verification successfully completedexpired- Verification expired without successful verificationfailed- Verification failed (seefailed_reasonfor details)
Error Handling
| Status Code | Description |
|---|---|
| 200 | Verification details retrieved successfully |
| 400 | Invalid or missing verification ID |
| 403 | Unauthorized - Invalid API key or verification doesn't belong to your company |
| 404 | Verification not found |
| 500 | Server error |
Error Response Format
Data Retention
Verification data is automatically deleted based on your organization's retention settings:
- The
kept_untilfield indicates when the verification data will be purged - You can configure retention periods in your dashboard settings
- Default retention periods apply based on your subscription plan
Best Practices
-
Store Verification IDs
- Save verification IDs returned from creation requests
- Use these IDs to track verification status
-
Poll Responsibly
- Always use webhooks instead of polling
Further Information
- Set up webhooks for real-time status updates
- Create verification requests
Need additional assistance? Contact us through [email protected]
© 2025 