---
title: "Get an identity verification attempt"
method: GET
path: "/identity-verifications/{identity_verification_id}/attempts/{attempt_id}"
tags: ["Identity Verification"]
---

# Get an identity verification attempt

`GET /identity-verifications/{identity_verification_id}/attempts/{attempt_id}`

## Request

- Base URL: `https://identity-verification.checkout.com`
- URL: `https://identity-verification.checkout.com/identity-verifications/{identity_verification_id}/attempts/{attempt_id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `identity-verification`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/identity-verifications/:identity_verification_id/attempts/:attempt_id/get.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p>
Get the details of a specific attempt for an [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities).

## Path parameters

- `identity_verification_id` string, required: The identity verification's unique identifier.
- `attempt_id` string, required: The unique identifier for the attempt.

## Response `200`

Identity verification attempt retrieved successfully

- object
  - `created_on` string, date-time, required: The date and time when the resource was created, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `modified_on` string, date-time, required: The date and time when the resource was modified, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `id` string, required: The unique identifier for the attempt.
  - `redirect_url` string, required: The URL to redirect the applicant to after the attempt.
  - `status` 'capture_aborted' | 'capture_in_progress' | 'checks_inconclusive' | 'checks_in_progress' | 'completed' | 'expired' | 'pending_redirection' | 'capture_refused' | 'terminated', required: The [attempt status](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Attempt_statuses).
  - `response_codes` IdvResponseCode[], required: One or more [response codes](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Response_codes) that provide more information about the status.
    - `code` integer, required: The [response code](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Response_codes).
    - `summary` string, required: The description of the [response code](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Response_codes).
  - `phone_number` IdvPhoneNumber: The applicant's mobile phone number, if sharing the attempt URL via SMS.
    - `country_code` string, required: The international [phone country code](https://www.checkout.com/docs/resources/codes/country-codes).
    - `number` string, required: The applicant's mobile number, without the country code.
  - `client_information` IdvClientInformation: The applicant's details.
    - `pre_selected_residence_country` string: The applicant's residence country. <br/>Standard – [ISO alpha-2 country code](/developer-resources/codes/country-codes) <br/>Example – `FR`
    - `pre_selected_document_issuing_country` string: The country that issued the applicant's identity document. <br/>Standard – [ISO alpha-2 country code](/developer-resources/codes/country-codes) <br/>Example – `FR`
    - `pre_selected_document_type` 'Driving licence' | 'ID' | 'Other' | 'Passport' | 'Residence Permit' | 'Travel Document' | 'Visa': The type of identity document.
    - `pre_selected_language` string, IETF BCP 47 language tag: The language you want to use for the user interface. <br/>Format – IETF BCP 47 language tag
  - `applicant_session_information` IdvApplicantSessionInformation, required: The details of the attempt.
    - `ip_address` string: The applicant's IP address during the attempt.
    - `number_of_sessions` integer: The number of sessions the applicant opened during the attempt.
    - `user_agent` string: The user agent of the browser the applicant used during the attempt.
    - `initial_device` 'desktop' | 'mobile': The type of device the applicant used to start the attempt.
    - `selected_documents` IdvSelectedDocument[]: The documents the applicant selected in order.
      - `country` string, ISO 3166-1 alpha-2: The applicant's nationality. <br/>Standard – [ISO alpha-2 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes) <br/>Example – `FR`
      - `document_type` 'Driving licence' | 'ID' | 'Other' | 'Passport' | 'Residence Permit' | 'Travel Document' | 'Visa': The type of identity document.
  - `_links` IdvAttemptLinks: The details of links related to the resource.
    - `self` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required
    - `verification_url` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)