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

# Verification levels

> Every fact has a level that says how far it can be trusted, and the evidence behind it.

Agentic ID does not treat a value as true because a source said so. What a source says is a claim. A fact becomes verified only through evidence that is independent of the claim: a direct check, or something the person or company did.

Every fact carries one of five levels.

## The five levels

| `level` | Meaning |
| - | - |
| `verified` | Fresh proof exists: a direct check passed, or the person or company did something that proves it. No newer evidence contradicts it |
| `corroborated` | Two or more independent sources claim the same value |
| `claimed` | One source says so |
| `contradicted` | The newest evidence says the value is wrong |
| `unknown` | No evidence, or the evidence has expired |

Rules that follow from this:

* **Independent means different origins.** Several sources that repeat the same underlying data count as one voice, not several.
* **The newest signal wins.** A contradiction newer than the proof makes the fact `contradicted`.
* **A catch-all mailbox never verifies an email.** The server accepts every address, so acceptance proves nothing.
* **Levels are never rounded up.** A fact is reported at the level it reached.

Enrich returns a `level` with every field. Show it wherever you show the value.

## Verification decays

Proof gets old. Each fact has a `recheck_at` time: after it, the level no longer holds without new evidence. Levels are worked out when you ask, so expired proof shows as expired at once.

## Read the facts for one ID

`GET /v1/facts/{id}` returns every fact's level and the evidence behind it. It is not charged. Your workspace must hold the ID.

```bash theme={null}
curl -s "https://YOUR_AGENTIC_ID_HOST/v1/facts/ic-7hN2pW9sD4fGk1Lm6QxRb8" \
  -H "Authorization: Bearer $AGENTIC_ID_API_KEY"
```

```json theme={null}
{
  "id": "ic-7hN2pW9sD4fGk1Lm6QxRb8",
  "kind": "person",
  "summary": "Not a verified person yet: 2 verified, 1 unknown. Missing: employer not corroborated.",
  "verified_id": false,
  "missing": ["employer not corroborated"],
  "facts": [
    {
      "fact": "work_email",
      "level": "verified",
      "reason": "mailbox accepts (probe)",
      "independent_sources": 1,
      "recheck_at": "2027-02-11T10:42:07.000Z",
      "evidence": [
        { "kind": "mailbox_accepts", "lineage": "probe", "source": "verifier", "observed_at": "2026-11-13T10:42:07.000Z" }
      ]
    },
    {
      "fact": "person_exists",
      "level": "verified",
      "reason": "replied (first_party)",
      "independent_sources": 0,
      "recheck_at": "2027-05-12T09:15:00.000Z",
      "evidence": [
        { "kind": "replied", "lineage": "first_party", "source": "your workspace", "observed_at": "2026-11-13T09:15:00.000Z" }
      ]
    },
    {
      "fact": "employer",
      "level": "unknown",
      "reason": "evidence has expired",
      "independent_sources": 0,
      "evidence": []
    }
  ]
}
```

### Top-level fields

**kind** `string`

`person` or `company`.

**verified\_id** `boolean`

Whether the ID as a whole is a Verified ID. See below.

**missing** `string[]`

What stops it being a Verified ID. Empty when `verified_id` is true.

**summary** `string`

One plain line: how many facts are at each level, and what is missing.

### Each fact

**fact** `string`

Which fact this is. One of `work_email`, `personal_email`, `phone`, `employer`, `title`, `person_exists`, `location`, `company_exists`, `company_domain`, `company_size`, `company_industry`, `company_country`.

**level** `string`

`verified`, `corroborated`, `claimed`, `contradicted` or `unknown`.

**reason** `string`

Why it is at that level, in plain words.

**independent\_sources** `number`

How many independent origins claim the value.

**recheck\_at** `string`

When the level stops holding without new evidence. ISO 8601. Absent when there is nothing to re-check.

**evidence** `object[]`

The evidence that set the level.

**evidence fields**

**kind** `string`

What was observed. See the table below.

**lineage** `string`

Where the evidence comes from, for example `first_party` (something a workspace saw happen), `probe` (a direct check), `registry` (an official register) or `web` (the company's own website).

**source** `string`

Who produced it. Your own reports show as `your workspace`.

**observed\_at** `string`

When it was observed. ISO 8601.

The values themselves are not in this answer. It tells you how far to trust a value you already have.

### Evidence kinds

| Group | `kind` values | Effect |
| - | - | - |
| Something the person or company did | `replied`, `meeting_booked`, `purchased`, `logged_in`, `form_submitted`, `crm_confirmed` | Proves |
| A direct check that passed | `mailbox_accepts`, `domain_live`, `mx_present`, `line_active`, `website_lists_person`, `registry_active` | Proves |
| A claim | `claim` | Counts as one voice |
| A direct check that failed | `mailbox_rejects`, `domain_dead`, `mx_missing`, `line_disconnected`, `registry_dissolved` | Contradicts |
| A problem a workspace reported | `bounced`, `wrong_person`, `left_company`, `number_wrong` | Contradicts |
| Not proof either way | `mailbox_catch_all`, `domain_redirects` | Recorded, never verifies |

Each kind counts only for the facts it can speak to. A mailbox that accepts mail proves a work email. It does not prove a job title.

## Verified ID

`verified_id` is true only when the ID as a whole meets a bar.

| Kind | Needs |
| - | - |
| Person | Fresh proof the person exists, at least one verified way to reach them, and an employer that is at least corroborated |
| Company | Proof the company exists, and a verified live domain |

When the bar is not met, `missing` says what is short:

| `missing` entry | Applies to |
| - | - |
| `no fresh proof the person exists` | Person |
| `no verified way to reach them` | Person |
| `employer not corroborated` | Person |
| `no fresh proof the company exists` | Company |
| `domain not verified` | Company |

## How feedback changes a level

Tell Agentic ID what happened after you used a value with `POST /v1/feedback`. It is not charged. See [Feedback](https://docs-agentic-id.icustomer.ai/products/feedback.md).

```bash theme={null}
curl -s "https://YOUR_AGENTIC_ID_HOST/v1/feedback" \
  -H "Authorization: Bearer $AGENTIC_ID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "ic-7hN2pW9sD4fGk1Lm6QxRb8", "field": "work_email", "outcome": "replied" }'
```

| `outcome` | Recorded as | Effect on your view of the fact |
| - | - | - |
| `replied` | `replied` | Proof for the value. For a person, also proof that the person exists |
| `confirmed` | `crm_confirmed` | Proof for the value. For a person, also proof that the person exists |
| `bounced` | `bounced` | Contradicts the value. It is no longer served to your workspace |
| `wrong_person` | `wrong_person` | Contradicts the value. It is no longer served to your workspace |

What to know about feedback:

* **It stays in your workspace.** Your report changes the level in your view of the ID only. It is never shown to another workspace. In `evidence` it appears with lineage `first_party` and source `your workspace`.
* **It adjusts trust in the source.** A good outcome counts toward the trust of the source that supplied the value, and a bad one counts against it.
* **It needs a held ID.** Feedback for an ID your workspace does not hold returns `404 feedback.not_held`.

A validate verdict also counts. When you validate a mailbox Agentic ID already knows, the verdict is recorded as a direct check on that person's work email.

## Errors

| Status | `code` | When |
| - | - | - |
| 400 | `request.invalid` | The `id` in the path is not an Agentic ID |
| 404 | `id.not_held` | Your workspace does not hold this ID. Resolve it first |

An unknown ID and an ID held only by someone else answer the same way.


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