Skip to main content
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

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.

Top-level fields

string
person or company.
boolean
Whether the ID as a whole is a Verified ID. See below.
string[]
What stops it being a Verified ID. Empty when verified_id is true.
string
One plain line: how many facts are at each level, and what is missing.

Each 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.
string
verified, corroborated, claimed, contradicted or unknown.
string
Why it is at that level, in plain words.
number
How many independent origins claim the value.
string
When the level stops holding without new evidence. ISO 8601. Absent when there is nothing to re-check.
object[]
The evidence that set the level.
The values themselves are not in this answer. It tells you how far to trust a value you already have.

Evidence kinds

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. When the bar is not met, missing says what is short:

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.
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

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