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

GET https://api.vericato.com/v1/verifications/{id}
Authorization: Bearer YOUR_API_KEY

Path Parameters

ParameterTypeDescription
idstringThe unique identifier of the verification request

Response

{
  "inputted_name": "John Doe",
  "status": "completed",
  "purpose": "identity_verification",
  "access_expires_at": "2025-12-14T10:30:00.000Z",
  "identified_name": "John William Doe",
  "identified_date": "2025-11-14T08:45:00.000Z",
  "verification_method": "passport",
  "failed_reason": null,
  "kept_until": "2025-12-14T10:30:00.000Z"
}

Response Fields

FieldTypeDescription
inputted_namestringThe name that was initially provided when creating the verification
statusstringCurrent status of the verification (pending, completed, expired, failed)
purposestringThe purpose of the verification
access_expires_atstringISO 8601 timestamp when the verification access for the person you want to verify themselves expires
identified_namestringThe verified name from the identity document (null if not completed)
identified_datestringISO 8601 timestamp when the verification was completed (null if not completed)
verification_methodstringThe method used for verification (e.g., itsme, idin,passport, id_card, drivers_license)
failed_reasonstringReason for failure if status is failed, otherwise null
kept_untilstringISO 8601 timestamp indicating how long the verification data will be retained for you

Example Request

const verificationId = "abc123def456";

const response = await fetch(`https://api.vericato.com/v1/verifications/${verificationId}`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${API_KEY}`
  }
});

const data = await response.json();
console.log(data);
import requests

verification_id = "abc123def456"
headers = {
    "Authorization": f"Bearer {API_KEY}"
}

response = requests.get(
    f"https://api.vericato.com/v1/verifications/{verification_id}",
    headers=headers
)

data = response.json()
print(data)
curl https://api.vericato.com/v1/verifications/abc123def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

Verification Status

The status field can have one of the following values:

  • pending - Verification request has been sent but not yet completed
  • completed - Verification successfully completed
  • expired - Verification expired without successful verification
  • failed - Verification failed (see failed_reason for details)

Error Handling

Status CodeDescription
200Verification details retrieved successfully
400Invalid or missing verification ID
403Unauthorized - Invalid API key or verification doesn't belong to your company
404Verification not found
500Server error

Error Response Format

{
  "error": "Verification not found"
}

Data Retention

Verification data is automatically deleted based on your organization's retention settings:

  • The kept_until field 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

  1. Store Verification IDs

    • Save verification IDs returned from creation requests
    • Use these IDs to track verification status
  2. Poll Responsibly

    • Always use webhooks instead of polling

Further Information

Need additional assistance? Contact us through [email protected]
© 2025 Vericato Logo

On this page