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

# Checks Reference

> Reference for the iDenfy KYB AI reviewer checks, including reasons each check may be skipped or fail and a diagnostic table for troubleshooting.

The AI reviewer runs up to 9 checks per company. This page documents when each check is skipped or marked as failed, plus a diagnostic table for common symptoms.

***

## Rules That Apply to All Checks

The following conditions block or skip **any** check, regardless of type:

* **No rule set configured for the partner** — the reviewer has no instructions to run. Nothing executes.
* **Rule set exists but contains no rules** — same result, nothing runs.
* **Rule targets a beneficiary type that is not present on the case** — the rule is silently skipped. No result is created and the frontend shows nothing for it.
* **Check ran but outcome is not in the accepted outcomes list** — the check is marked Unaccepted and the company is Denied (unless an override applies).
* **Unresolved AML flags on the case** — even if all checks pass, the reviewer overrides Approve → **Flagged** and does not complete the case. It stays in the previous status until the flags are resolved manually.
* **Concurrent review attempts** — the system locks per company. If two reviews are triggered simultaneously, only one runs; the other is rejected.

***

## Check-Specific Skip and Failure Reasons

### 1. Details Comparison (AI / Gemini)

Compares company or person data against a source document using Google Gemini.

**Skipped when:**

* No data source document type is configured (e.g. no credit bureau, no Companies House report).
* The configured document type is in settings but no document was uploaded or fetched for this company.
* The fields to compare data in [**Settings**](/guides/dashboard/settings/ai-reviewer) are not set.
* The document file is unreadable or corrupted.
* The Gemini API call fails or times out.

**Special failure — "Not Listed":**

When checking a beneficiary (e.g. a director), Gemini may report that the person's name does not appear in the document at all. Whether this counts as a failure depends on how `beneficiary_not_found_status` is configured in the rule. If not configured, it defaults to Unaccepted.

***

### 2. AML Check

Checks AML, sanctions, and PEP screening status for the company or a beneficiary.

**Skipped when:**

* No AML check record exists for the target (company or person).

**Failed when:**

* Flags were found and the rule only accepts "No Flags".
* The AML check was never performed at all (treated as Unaccepted, not Skipped).

***

### 3. Identity Verification (IDV)

Checks whether a beneficiary passed KYC.

**Skipped when:**

* The rule is configured for the main company (IDV only applies to individual people).
* The beneficiary has no linked client record.
* The beneficiary's client has no KYC or identification record.

**Failed when:**

* The IDV status is not in the accepted list (e.g. rule requires Approved but the person is Rejected or Pending).

***

### 4. Address Verification

Checks whether the company's address was verified.

**Skipped when:** No address verification record exists for the company.

**Failed when:** The status is below the accepted threshold (e.g. rule requires Verified but the result is only Partially Verified).

***

### 5. Address Audit

Checks the risk level of the company's address.

**Skipped when:** No address audit record exists.

**Failed when:** The risk level is higher than the rule accepts (e.g. rule accepts up to Medium risk but the result is High).

***

### 6. Website Audit

Checks the risk level of the company's website.

**Skipped when:** No website audit record exists.

**Failed when:** The risk level exceeds the configured threshold — same logic as Address Audit.

***

### 7. VAT Verification

Checks VAT registration validity.

**Skipped when:** No VAT verification record exists. The check defaults to a "Not Checked" outcome, which may or may not be acceptable depending on rule configuration.

***

### 8. EIN Verification (US Only)

Same as VAT verification but for US EIN numbers.

**Skipped when:** No EIN verification record exists. Defaults to "Not Checked".

***

### 9. Proof of Address (POA)

Checks proof of address status for the company or a person.

**Skipped when:** No POA check record exists for the target entity.

**Failed when:** Status is No Match or Not Compared, and the rule requires Match.

***

## Quick Diagnostic Guide

| Symptom                                        | Most Likely Cause                                                               |
| ---------------------------------------------- | ------------------------------------------------------------------------------- |
| Check not shown at all in the UI               | No result created — beneficiary type missing, or data source document absent    |
| All checks skipped                             | Rule set is configured but contains no rules                                    |
| Check shows "Skipped" despite correct settings | Missing upstream data: no document uploaded, no AML check run, no address audit |
| Approved, then immediately Flagged             | Unresolved AML flags exist on the case                                          |
| Beneficiary check skipped                      | No beneficiary of that type (Director, UBO, etc.) added to the case             |
| Gemini / Details Comparison skipped            | Document upload failed, file is corrupted, or Gemini API error                  |

<Tip>
  For partner-specific rule set configuration, contact the integrations team. For data pipeline issues (why an audit or AML check never ran), contact engineering.
</Tip>