---
title: "Get face authentication attempts"
method: GET
path: "/face-authentications/{face_authentication_id}/attempts"
tags: ["Face Authentication"]
---

# Get face authentication attempts

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

## Request

- Base URL: `https://identity-verification.checkout.com`
- URL: `https://identity-verification.checkout.com/face-authentications/{face_authentication_id}/attempts`
- 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/face-authentications/:face_authentication_id/attempts/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 all attempts for a specific [face authentication](https://www.checkout.com/docs/business-operations/manage-identities/authenticate-with-biometrics).

## Path parameters

- `face_authentication_id` string, required

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

Face authentication attempts retrieved successfully

- FavAttemptResponseList
  - `total_count` integer, required: The total number of attempts.
  - `skip` integer, required: The number of attempts you want to skip, to help you view the relevant attempt. <br/>Example – There are 10 attempts. If you provide `6`, the first six attempts are skipped.
  - `limit` integer, required: The maximum number of attempts you want returned. <br/>Example – There are 10 attempts. If you set `limit` to `5`, but skip the first six, four attempts are returned.
  - `data` FavAttemptResponse[], required: The details of the attempt.
    - `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`
  - `_links` object, required: The details of links to the previous, current, and next resources.
    - `self` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required
    - `next` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required
    - `previous` 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)