DOCUMENTATION / VERIFICATION RESPONSE

Verification response

OpenAPI 3.1 ↗

Understand the CompanyProof verification response: proof IDs, claim verdicts, observed values, corrections, evidence and timestamps.

BASE URLhttps://companyproof.ai/v2JSON · Bearer authentication

RESPONSE MODEL

Evidence travels with every verdict.

The proof ID links the resolved company, individual claims, source context, decision events and future monitoring state. corrected means a supported field was found but its published value did not match the observed value.

verified

The published value matches the observed source value.

corrected

The observed source value differs from the published value.

unsupported

The selected source did not return a value for that field.

stale

A monitored value that previously matched no longer does.

201 · VERIFICATION RESPONSE
{
  "proof_id": "prf_7dcf18e8a2f6c06a9a10d2c1",
  "company": {
    "id": "sandbox_company_001",
    "name": "COMPANYPROOF SANDBOX LIMITED",
    "registration_number": "CP000001",
    "country": "GB"
  },
  "claims": [
    {
      "claim_id": "clm_f3df4360de139d4f9d323779",
      "field": "status",
      "published": "Active",
      "observed": "Active",
      "verdict": "verified",
      "explanation": "The published value matches the sample company record.",
      "evidence": {
        "source_name": "CompanyProof Sandbox",
        "source_url": "https://companyproof.ai/docs#environments",
        "source_record_id": "sandbox_company_001",
        "retrieved_at": "2026-08-29T10:42:11.000Z"
      }
    },
    {
      "claim_id": "clm_15c1c8ae33b2520c5c9a9701",
      "field": "incorporation_date",
      "published": "2021-01-15",
      "observed": "2020-01-15",
      "verdict": "corrected",
      "explanation": "The published value conflicts with the sample company record.",
      "evidence": {
        "source_name": "CompanyProof Sandbox",
        "source_url": "https://companyproof.ai/docs#environments",
        "source_record_id": "sandbox_company_001",
        "retrieved_at": "2026-08-29T10:42:11.000Z"
      }
    }
  ],
  "summary": {
    "verified": 1,
    "corrected": 1,
    "stale": 0,
    "unsupported": 0
  },
  "monitoring": "off",
  "latency_ms": 0
}