GET
/v1/identity/verification_reportsList verification reports
Lists verification reports generated from identity verification attempts. Use client_reference_id, verification_session, and type to filter results, and use cursor parameters with limit to control pagination.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
client_reference_idstringoptional
Reference for the user or verification in your systems, such as a customer ID or session ID. Maximum 5000 characters.
createdobjectoptional
Filter reports by creation time using a Unix timestamp or a range object with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
Cursor that identifies the object before the page you want to retrieve. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in each response object. Each value must be no longer than 5000 characters.
limitintegeroptional
Maximum number of reports to return. Must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
Cursor that identifies the object after the page you want to retrieve. Maximum 5000 characters.
typestringoptional
Filter reports by verification type: `document` or `id_number`.
verification_sessionstringoptional
Return reports created by the specified VerificationSession or VerificationIntent. Maximum 5000 characters.
200Returns a paginated list object containing verification reports, the list URL, the `has_more` indicator, and the report data.
dataarray<VerificationReport>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
client_reference_id, ending_before, starting_after, and verification_session must be no longer than 5000 characters. limit accepts between 1 and 100 objects and defaults to 10, while type must be document or id_number.