---
title: "Submit biometric authentication"
method: POST
path: "/v3/authentication"
tags: ["Biometric Authentication"]
---

# Submit biometric authentication

`POST /v3/authentication`

Authenticates a user by comparing a submitted selfie against their enrolled image. The selfie and liveness images are uploaded, validated at entry, then queued for async ML processing (passive liveness, active liveness, face matching). Results are delivered via callback URL.
Supports `use_enrolled_image: true` to skip selfie/liveness upload and re-use the enrolled image for the comparison (useful for server-side re-verification).

## Headers

- `SmileID-Source-SDK` string
- `SmileID-Source-SDK-Version` string
- `SmileID-Timestamp` string, date-time
- `SmileID-Request-Signature` string
- `User-ID` string

## Response `202`

Accepted — job queued for async processing.

- AcceptedResponse
  - `status` 'accepted', required — Acceptance status for queued verification requests.
  - `message` string, required — Human-readable acceptance message.
  - `job_id` string, required — TypeID format verification identifier for tracking.
  - `user_id` string, required — TypeID format user identifier, or partner-provided user identifier.
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the verification was created.

## Other responses

- `400` — Bad Request — validation error.
- `401` — Unauthorized — invalid or missing authentication credentials.
- `402` — Payment Required — insufficient wallet balance.
- `403` — Forbidden — partner not authorized for this product or IP.
- `415` — Unsupported Media Type — request must be multipart/form-data.
- `429` — Too Many Requests — rate limit exceeded.
- `500` — Internal Server Error

---

[API](https://skmtc.net/smileidentity/apis/v3-authentication-token-api.md) · [All operations](https://skmtc.net/smileidentity/apis/v3-authentication-token-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smileidentity/v3-authentication-token-api/revisions/9f178647f9b8/schema)