Get Verification Status
Verification
Get Verification Status
Retrieves the current status of a verification process. This endpoint allows you to check the progress and results of an ongoing or completed verification.
Use Cases
- Polling for verification completion
- Checking verification results
- Determining if additional inputs are needed
- Retrieving verification outcome details
Notes
- This endpoint requires an API key with verification read permissions
- Status updates may take time to process depending on the verification type
- For real-time updates, configure webhooks instead of polling this endpoint
GET
Get Verification Status
Path Parameters
Unique identifier of the verification.
Response
Verification status information
Unique identifier for the verification
Example:
"85c94e71-6e3f-4a19-b15c-781d8a876542"
Current status of the verification:
- PENDING: Verification has been created but not started
- INITIATED: Verification has started but inputs are pending
- PROCESSING: Inputs received and verification is in progress
- COMPLETED: Verification completed successfully
- FAILED: Verification failed
- ABANDONED: Verification was abandoned by the user
- EXPIRED: Verification session expired
Example:
"COMPLETED"
Result of the verification (if completed):
- APPROVED: Verification passed all checks
- DECLINED: Verification failed one or more checks
- MANUAL_REVIEW: Verification requires manual review
Example:
"APPROVED"
When the verification was completed
Example:
"2023-06-15T15:30:00Z"
Status of individual verification steps
List of inputs that are still required
Example:
[]