---
title: "List VerificationReports"
method: GET
path: "/v1/identity/verification_reports"
---

# List VerificationReports

`GET /v1/identity/verification_reports`

List all verification reports.

## Query parameters

- `client_reference_id` string
- `created` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer
- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string
- `type` 'document' | 'id_number'
- `verification_session` string

## Response `200`

Successful response.

- object
  - `data` IdentityVerificationReport[], required
    - `client_reference_id` string, nullable — A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `document` GelatoDocumentReport — Result from a document check
      - `address` Address
        - `city` string, nullable — City, district, suburb, town, or village.
        - `country` string, nullable — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        - `line1` string, nullable — Address line 1, such as the street, PO Box, or company name.
        - `line2` string, nullable — Address line 2, such as the apartment, suite, unit, or building.
        - `postal_code` string, nullable — ZIP or postal code.
        - `state` string, nullable — State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
      - `dob` GelatoDataDocumentReportDateOfBirth — Point in Time
        - `day` integer, nullable — Numerical day between 1 and 31.
        - `month` integer, nullable — Numerical month between 1 and 12.
        - `year` integer, nullable — The four-digit year.
      - `error` GelatoDocumentReportError
        - `code` 'document_expired' | 'document_type_not_supported' | 'document_unverified_other', nullable — A short machine-readable string giving the reason for the verification failure.
        - `reason` string, nullable — A human-readable message giving the reason for the failure. These messages can be shown to your users.
      - `expiration_date` GelatoDataDocumentReportExpirationDate — Point in Time
        - `day` integer, nullable — Numerical day between 1 and 31.
        - `month` integer, nullable — Numerical month between 1 and 12.
        - `year` integer, nullable — The four-digit year.
      - `files` string[], nullable — Array of [File](https://docs.stripe.com/api/files) ids containing images for this document.
      - `first_name` string, nullable — First name as it appears in the document.
      - `issued_date` GelatoDataDocumentReportIssuedDate — Point in Time
        - `day` integer, nullable — Numerical day between 1 and 31.
        - `month` integer, nullable — Numerical month between 1 and 12.
        - `year` integer, nullable — The four-digit year.
      - `issuing_country` string, nullable — Issuing country of the document.
      - `last_name` string, nullable — Last name as it appears in the document.
      - `number` string, nullable — Document ID number.
      - `sex` '[redacted]' | 'female' | 'male' | 'unknown', nullable — Sex of the person in the document.
      - `status` 'unverified' | 'verified', required — Status of this `document` check.
      - `type` 'driving_license' | 'id_card' | 'passport', nullable — Type of the document.
      - `unparsed_place_of_birth` string, nullable — Place of birth as it appears in the document.
      - `unparsed_sex` string, nullable — Sex as it appears in the document.
    - `email` GelatoEmailReport — Result from a email check
      - `email` string, nullable — Email to be verified.
      - `error` GelatoEmailReportError
        - `code` 'email_unverified_other' | 'email_verification_declined', nullable — A short machine-readable string giving the reason for the verification failure.
        - `reason` string, nullable — A human-readable message giving the reason for the failure. These messages can be shown to your users.
      - `status` 'unverified' | 'verified', required — Status of this `email` check.
    - `id` string, required — Unique identifier for the object.
    - `id_number` GelatoIdNumberReport — Result from an id_number check
      - `dob` GelatoDataIdNumberReportDate — Point in Time
        - `day` integer, nullable — Numerical day between 1 and 31.
        - `month` integer, nullable — Numerical month between 1 and 12.
        - `year` integer, nullable — The four-digit year.
      - `error` GelatoIdNumberReportError
        - `code` 'id_number_insufficient_document_data' | 'id_number_mismatch' | 'id_number_unverified_other', nullable — A short machine-readable string giving the reason for the verification failure.
        - `reason` string, nullable — A human-readable message giving the reason for the failure. These messages can be shown to your users.
      - `first_name` string, nullable — First name.
      - `id_number` string, nullable — ID number. When `id_number_type` is `us_ssn`, only the last 4 digits are present.
      - `id_number_type` 'br_cpf' | 'sg_nric' | 'us_ssn', nullable — Type of ID number.
      - `last_name` string, nullable — Last name.
      - `status` 'unverified' | 'verified', required — Status of this `id_number` check.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `object` 'identity.verification_report', required — String representing the object's type. Objects of the same type share the same value.
    - `options` GelatoVerificationReportOptions
      - `document` GelatoReportDocumentOptions
        - `allowed_types` string[] — Array of strings of allowed identity document types. If the provided identity document isn’t one of the allowed types, the verification check will fail with a document_type_not_allowed error code.
        - `require_id_number` boolean — Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
        - `require_live_capture` boolean — Disable image uploads, identity document images have to be captured using the device’s camera.
        - `require_matching_selfie` boolean — Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://docs.stripe.com/identity/selfie).
      - `id_number` GelatoReportIdNumberOptions
    - `phone` GelatoPhoneReport — Result from a phone check
      - `error` GelatoPhoneReportError
        - `code` 'phone_unverified_other' | 'phone_verification_declined', nullable — A short machine-readable string giving the reason for the verification failure.
        - `reason` string, nullable — A human-readable message giving the reason for the failure. These messages can be shown to your users.
      - `phone` string, nullable — Phone to be verified.
      - `status` 'unverified' | 'verified', required — Status of this `phone` check.
    - `selfie` GelatoSelfieReport — Result from a selfie check
      - `document` string, nullable — ID of the [File](https://docs.stripe.com/api/files) holding the image of the identity document used in this check.
      - `error` GelatoSelfieReportError
        - `code` 'selfie_document_missing_photo' | 'selfie_face_mismatch' | 'selfie_manipulated' | 'selfie_unverified_other', nullable — A short machine-readable string giving the reason for the verification failure.
        - `reason` string, nullable — A human-readable message giving the reason for the failure. These messages can be shown to your users.
      - `selfie` string, nullable — ID of the [File](https://docs.stripe.com/api/files) holding the image of the selfie used in this check.
      - `status` 'unverified' | 'verified', required — Status of this `selfie` check.
    - `type` 'document' | 'id_number' | 'verification_flow', required — Type of report.
    - `verification_flow` string — The configuration token of a verification flow from the dashboard.
    - `verification_session` string, nullable — ID of the VerificationSession that created this report.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/stripe-api-2.md) · [All operations](https://skmtc.net/stripe/apis/stripe-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/stripe-api-2/versions/3653ad45bbec/schema)