---
title: "Retrieve a face authentication"
method: GET
path: "/v2/face-authentications/{face_authentication_id}"
tags: ["Face authentications"]
---

# Retrieve a face authentication

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

## Request

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

This endpoint allows you to get the detailed results of a face authentication.

## Path parameters

- `face_authentication_id` string, required: Face authentication unique identifier.

## Response `200`

Face authentication retrieved

- FaceAuthenticationOutputGet
  - `id` string: Face authentication unique identifier.
  - `status` 'created' | 'pending' | 'capture_in_progress' | 'checks_in_progress' | 'approved' | 'declined' | 'retry_required' | 'refused' | 'inconclusive': Status of the verification.
  - `response_codes` ResponseCodes[]
    - `code` integer, required: The numeric code of the response code.
    - `summary` string, required: A descriptive code of the response code.
  - `risk_labels` RiskLabel[]: Risk assessment labels
  - `face` VerificationFace
    - `image_signed_url` string, nullable
  - `_links` FaceAuthenticationLinks
    - `self` HalLink, required
      - `href` string, uri, required
    - `applicant` HalLink, required
      - `href` string, uri, required
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Applicant unique identifier.
  - `webhook_url` string, uri
  - `created_on` string, date-time, required: UTC Date time when the resource was created
  - `modified_on` string, date-time, required: UTC Date time when the resource was modified

## Other responses

- `404`: Face authentication not found
- `500`: Internal server error

---

[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)