Skip to main content

Professional identity and licensing evidence

Question: who is this legal professional, and what is the evidence?

OLIP does not have a "verified lawyer" flag. It has evidence with a level, a source and a date, and a fixed sentence that says exactly that.

Three evidence levels​

verification.levelMeaningchecked_atAllowed wording (display_statement)
indexedCopied from a dataset. Never checked against the licensing authority.MUST be null"Copied from … on . Not checked against the official source."
official_source_checkedCompared with the licensing authority's own record. Includes the source URL and an evidence hash.The date the source says its data is current, not the download date"Checked against on : ."
authority_issued_credentialA credential signed by the licensing authority itself.issuer's date"Credential issued by ." None are known to exist today.

Rules that follow from this:

  • Agents MUST show display_statement without upgrading it. An indexed record MUST NOT be called verified.
  • A record is matched to a person by jurisdiction plus license number, never by name alone.
  • Each source declares freshness_days. Past it, the status becomes stale and the statement says so.

Four separate facts that are often blurred​

FactFieldValues
License evidencelicenses[].verificationlevels above
Profile claimclaim.statusunclaimed, claimed_unverified, claimed_verified, unknown
Lawyer-reported informationself_reportedpractice areas, languages, service territory, labeled as self-reported
Intake endpointintake_endpoint.statusnone, declared, conformance_tested, active, unhealthy

An indexed record is not a claimed profile, which is not an active endpoint, which is not a paying customer of anyone. commercial.paid_placement and commercial.affects_order MUST be false in OLIP results.

Fictional examples​

Official-source check (from 04-identity-verified.json, shortened):

{
"jurisdiction": "US-CA",
"license_id": "TEST-CA-100001",
"status": { "value": "active", "status": "official_source_checked", "as_of": "2026-10-30T00:00:00-07:00" },
"verification": {
"level": "official_source_checked",
"checked_at": "2026-10-30T00:00:00-07:00",
"freshness_days": 120,
"source": {
"name": "Fictional US-CA licensing registry (test data)",
"url": "https://registry.example.test/US-CA/TEST-CA-100001",
"data_as_of": "2026-10-30T00:00:00-07:00",
"evidence_sha256": "sha256:0000…0001"
}
},
"display_statement": "Checked against the fictional US-CA registry on 2026-10-30: listed as active. This is a record check, not an endorsement."
}

Indexed only (from 05-identity-indexed.json):

{
"status": { "value": "active", "status": "indexed_unverified", "as_of": "2026-10-02T00:00:00-07:00" },
"verification": { "level": "indexed", "checked_at": null, "freshness_days": 120,
"source": { "name": "Fictional bulk dataset (test data)", "url": "https://dataset.example.test/lawyers.csv", "evidence_sha256": null } },
"display_statement": "Copied from a public dataset on 2026-10-02. Not checked against the official source."
}

When the official source cannot be reached​

If an official source is unavailable or blocks automated checks, keep the last evidence with its real date and let freshness expire it to stale. Do not convert an old check into a new one, and do not substitute a self-report for an official check. See Recovery.

Normative text: spec 5.1.