---
title: "Retrieve an ID Verification check"
method: GET
path: "/v1/checks/id_verification/{id}"
tags: ["ID Verification check"]
---

# Retrieve an ID Verification check

`GET /v1/checks/id_verification/{id}`

Returns detailed information about the specified ID Verification check.

---

#### See also  
Learn more about [Id verification checks](./id-verification-checks-guide)  
Learn more about [Files](./files-guide)

## Path parameters

- `id` string, uuid, required

## Response `200`

**ℹ️ Click to see full payload**

- IdVerificationCheck
  - `id` string, uuid, required
  - `individual_id` string, uuid, required
  - `is_internal` boolean, required
  - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required — ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
  - `type` 'id_verification', required
  - `subtype` string, nullable, required — Currently always null for `id_verification` Check
  - `last_activity_at` string, date-time, required — Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `data` IdVerificationCheckData, required
    - `result` 'approved' | 'rejected' | 'error', nullable, required
    - `settings` IdVerificationCheckDataSettings, required
      - `automatic_approval` boolean, required
      - `automatic_rejection` boolean, required
      - `vendor` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
      - `mode` 'liveness' | 'auto' | 'expert' | 'certified' | 'default', required
      - `redirect_url` string, required
    - `vendor` union, required
      - IdVerificationCheckDataOnfidoVendor
        - `verification_ref` string, required
        - `verification_url` string, required — The URL has a 15 min validity
        - `verification_status` string, required
        - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `comment` string, nullable, required
        - `report_file_id` string, nullable, required
        - `name` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
        - `sdk_token` string, nullable, required — SDK token for Onfido SDK integration
      - IdVerificationCheckDataVeriffVendor
        - `verification_ref` string, required
        - `verification_url` string, required — The URL has a 15 min validity
        - `verification_status` string, required
        - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `comment` string, nullable, required
        - `report_file_id` string, nullable, required
        - `name` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
      - IdVerificationCheckDataCheckoutVendor
        - `verification_ref` string, required
        - `verification_url` string, required — The URL has a 15 min validity
        - `verification_status` string, required
        - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `comment` string, nullable, required
        - `report_file_id` string, nullable, required
        - `name` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
      - IdVerificationCheckDataUbbleVendor
        - `verification_ref` string, required
        - `verification_url` string, required — The URL has a 15 min validity
        - `verification_status` string, required
        - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `comment` string, nullable, required
        - `report_file_id` string, nullable, required
        - `name` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
      - IdVerificationCheckDataIdnowVendor
        - `verification_ref` string, required
        - `verification_url` string, required — The URL has a 15 min validity
        - `verification_status` string, required
        - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
        - `comment` string, nullable, required
        - `report_file_id` string, nullable, required
        - `name` 'ubble' | 'checkout' | 'veriff' | 'onfido' | 'idnow', required
    - `review` Review, required
      - `comment` string, nullable, required
      - `reviewed_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `reviewer_type` 'user' | 'system' | 'api', nullable, required
      - `user` NestedUser, required
        - `id` string, uuid, required
        - `first_name` string, required
        - `last_name` string, required
        - `email` string, email, required
    - `detailed_results` IdVerificationCheckDataDetailedResults, required
      - `document` DetailedResultsDocument, required
        - `data_validation` 'approved' | 'rejected' | 'error', nullable, required
        - `data_consistency` 'approved' | 'rejected' | 'error', nullable, required
        - `image_integrity` 'approved' | 'rejected' | 'error', nullable, required
        - `visual_authenticity` 'approved' | 'rejected' | 'error', nullable, required
        - `compromised_document` 'approved' | 'rejected' | 'error', nullable, required
        - `data_comparison` 'approved' | 'rejected' | 'error', nullable, required
      - `face` IdVerificationCheckDataDetailedResultsFace, required
        - `face_comparison` 'approved' | 'rejected' | 'error', nullable, required
        - `image_integrity` 'approved' | 'rejected' | 'error', nullable, required
        - `visual_authenticity` 'approved' | 'rejected' | 'error', nullable, required
    - `information` IdVerificationCheckDataInformation, required
      - `document_type` 'passport' | 'identity_card' | 'driving_license' | 'residence_permit' | 'visa' | 'other', nullable, required
      - `document_number` string, nullable, required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `gender` string, nullable, required
      - `nationality` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
      - `birth_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
      - `birth_place` string, nullable, required — City name or "in the air" or "at sea"
      - `birth_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
      - `expiration_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
      - `issuing_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
      - `issuing_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
      - `mrz` string, nullable, required
      - `ip_address` string, nullable, required — IP Address of the device used to complete the vendor ID Verification flow
      - `front_file_id` string, nullable, required
      - `back_file_id` string, nullable, required
      - `signature_file_id` string, nullable, required — Signature page file for specific document type such as the French passport
      - `face_file_id` string, nullable, required
      - `video_file_id` string, nullable, required

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Make sure the identifier specified in the URL is a valid UUID
- `404` — No ID Verification check can be found.

---

[API](https://skmtc.net/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.net/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotfile/api-specifications/versions/36393567057b/schema)