> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proofage.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity (KYC)

> Confirms a person is who their identity document says: the document is read and checked, the person is live, and the selfie matches the portrait.

The Identity (KYC) check confirms that a person is who their identity document says they are. It has three parts:

| Part | What it checks |
| - | - |
| The document | It is genuine, readable, valid and complete. Described on this page. |
| [Liveness and anti-spoofing](/core-technology/liveness) | The selfie is of a live person in front of the camera. |
| [Face match](/core-technology/face-match) | The selfie matches the document's portrait. |

The document checks on this page also run in [Age verification by ID document](/core-technology/age-by-document), and in a [Facial age estimation](/core-technology/age-estimation) that asks for an ID.

## Supported documents

Identity documents from 190+ countries and territories: passports, national ID cards, driving licences and residence permits. See [Supported documents](/getting-started/supported-documents).

## Where it runs

| Workspace type | Document checks |
| - | - |
| Identity (KYC) | Yes |
| Age verification by ID document | Yes |
| Facial age estimation | Only when the selfie can't confirm 18+ and the person adds an ID |

## What is checked on the document

* **The capture**: the whole document is in the frame, in focus, without glare, and the text is readable. Problems here ask the person to retake it.
* **Authenticity**: the image is a real document, not a screen, a print or a photo of a photo, and shows no signs of editing, replaced portraits or overlaid text.
* **Condition**: the document is not torn, cut or folded over its text.
* **Data**: the fields the check needs are present, and the document is not expired, unless the workspace accepts expired documents.
* **The holder**: the selfie matches the portrait; see [Face match](/core-technology/face-match).

## Workspace setting

**Allow expired documents** (off by default) accepts documents past their expiry date. With it off, an expired document asks the person for another one.

## In the API and the webhook

`GET /v1/verifications/{id}/document` returns what was read (the document type and issuing country, and eleven fields: names, date of birth, sex, nationality, place of birth, address, document number, issue and expiry dates) and the images; see [Reading results](/integration/retrieving-results). The webhook carries the same `document` object, without the images; see [Webhooks](/integration/webhooks#payload). A failed check sets the verification's `reason`.

## Reasons

| Code | Outcome |
| - | - |
| `document.ai.not_a_document` | Declined |
| `document.ai.image_manipulation` | Declined |
| `document.ai.suspicious_words` | Declined |
| `document.front.tampering.suspected`, `document.back.tampering.suspected` | Declined |
| `document.front.tampering.text_overlay_suspected` | Declined |
| `document.front.tampering.portrait_replaced_suspected` | Declined |
| `document.front.not_a_document_suspected`, `document.back.not_a_document_suspected` | Declined |
| `document.checks.not_provided` | Declined |
| `document.expired` | Resubmission requested |
| `document.fields.required_missing` | Resubmission requested |
| `document.front.blur.high`, `document.back.blur.high` | Resubmission requested |
| `document.front.glare.high`, `document.back.glare.high` | Resubmission requested |
| `document.front.framing.not_fully_in_frame`, `document.back.framing.not_fully_in_frame` | Resubmission requested |
| `document.front.data.not_readable`, `document.back.data.not_readable` | Resubmission requested |
| `document.front.damaged.torn_or_cut`, `document.front.damaged.folded_over_text` | Resubmission requested |

Spoofed document images are covered on [Liveness and anti-spoofing](/core-technology/liveness); every code is in [Decision reasons](/core-technology/decision-reasons).

## What the person is asked to do

Photograph the document flat on a plain surface, the whole document in the frame, in good light without glare. If the document is damaged or expired, use another one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.