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.
level with every field. Show it wherever you show the value.
Verification decays
Proof gets old. Each fact has arecheck_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
Each fact
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.When the level stops holding without new evidence. ISO 8601. Absent when there is nothing to re-check.
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 withPOST /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
evidenceit appears with lineagefirst_partyand sourceyour 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.
Errors
An unknown ID and an ID held only by someone else answer the same way.

