---
title: "List ID document verification attempts"
method: GET
path: "/v2/id-document-verifications/{id_document_verification_id}/attempts"
tags: ["ID document verifications"]
---

# List ID document verification attempts

`GET /v2/id-document-verifications/{id_document_verification_id}/attempts`

## Request

- Base URL: `https://api.ubble.ai`
- URL: `https://api.ubble.ai/v2/id-document-verifications/{id_document_verification_id}/attempts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubble/apis/checkout-com-identity-verification/docs/v2/id-document-verifications/:id_document_verification_id/attempts/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to list all attempts of an ID document verification.

Attempts are returned ordered by creation date, newest first.

The response is paginated (see [Pagination](#section/API-standards/Pagination) section).
You can navigate through pages using the `skip` and `limit` query parameters or by following the URLs in the `_links` object.

## Path parameters

- `id_document_verification_id` string, required

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

ID document verification attempts retrieved successfully

- IdDocumentVerificationAttemptOutputList
  - `total_count` integer: Total number of items available across all pages
  - `skip` integer: Number of items skipped (offset from the start)
  - `limit` integer: Maximum number of items returned in this page
  - `_links` ListLinks
    - `self` HalLink, required
      - `href` string, uri, required
    - `previous` HalLink
      - `href` string, uri, required
    - `next` HalLink
      - `href` string, uri, required

## Other responses

- `404`: The provided document verification ID is not valid
- `500`: An error occurred while fetching the attempts

---

[API](https://skmtc.dev/ubble/apis/checkout-com-identity-verification.md) - [All operations](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/llms.txt) - [OpenAPI document](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/revisions/739e9da12584?raw)