---
title: "List attempts"
method: GET
path: "/v2/face-authentications/{face_authentication_id}/attempts"
tags: ["Face authentications"]
---

# List attempts

`GET /v2/face-authentications/{face_authentication_id}/attempts`

## Request

- Base URL: `https://api.ubble.ai`
- URL: `https://api.ubble.ai/v2/face-authentications/{face_authentication_id}/attempts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubble/apis/checkout-com-identity-verification/docs/v2/face-authentications/:face_authentication_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 a face authentication.

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

- `face_authentication_id` string, required

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

List attempts

- FaceAuthenticationAttemptResponseList
  - `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 face authentication 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)