---
title: "Retrieve a VerificationReport"
method: GET
path: "/v1/identity/verification_reports/{report}"
---

# Retrieve a VerificationReport

`GET /v1/identity/verification_reports/{report}`

Retrieves an existing VerificationReport

## Path parameters

- `report` string, required

## Query parameters

- `expand` string[]

## Response `200`

Successful response.

- IdentityVerificationReport — A VerificationReport is the result of an attempt to collect and verify data from a user. The collection of verification checks performed is determined from the `type` and `options` parameters used. You can find the result of each verification check performed in the appropriate sub-resource: `document`, `id_number`, `selfie`. Each VerificationReport contains a copy of any data collected by the user as well as reference IDs which can be used to access collected images through the [FileUpload](https://docs.stripe.com/api/files) API. To configure and create VerificationReports, use the [VerificationSession](https://docs.stripe.com/api/identity/verification_sessions) API. Related guide: [Accessing verification results](https://docs.stripe.com/identity/verification-sessions#results).
  - `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.

## Other responses

- `default` — Error response.

---

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