Skip to main content
A report summarizes the verification outcome for a completed job. It includes a score, per-claim results, identity resolution, and evidence sources.

Score overview

Scores range from 1 to 5 (integer). Peepal weights each claim category as follows:
  • Identity: 0.3
  • Employment: 0.4
  • Education: 0.2
  • Business: 0.1
Scores are adjusted by claim confidence (1-5), claim status, and weights.

Identity resolution

Identity resolution determines whether the person seed matches available public profiles.
  • status: matched, ambiguous, no_match
  • confidence: 1-5 confidence for the legacy status
  • identity_status (optional): confirmed, high_confidence, likely, possible, no_match
  • identity_confidence (optional): 1-5 confidence for identity status
  • profiles (optional): discovered profiles with type and primary flag

Report shape

{
  "job_id": "job_01HXYZ",
  "status": "completed",
  "score": 4,
  "score_breakdown": {
    "identity": 5,
    "employment": 4,
    "education": 3,
    "business": 2
  },
  "identity_resolution": {
    "status": "matched",
    "confidence": 4,
    "identity_status": "high_confidence",
    "identity_confidence": 4,
    "profiles": [
      {
        "url": "https://www.linkedin.com/in/ada-lovelace",
        "type": "linkedin",
        "title": "Ada Lovelace | LinkedIn",
        "is_primary": true
      }
    ],
    "candidates": [
      {
        "label": "Ada Lovelace",
        "confidence": 4,
        "profile_urls": ["https://www.linkedin.com/in/ada-lovelace"]
      }
    ]
  },
  "claims": [
    {
      "claim_key": "edu_1",
      "claim_type": "education",
      "status": "verified",
      "confidence": 4,
      "matched_value": {
        "school": "University of London"
      },
      "evidence": [{ "source_id": "src_01HABC" }],
      "explanation": "Evidence supports the education claim."
    }
  ],
  "sources": [
    {
      "source_id": "src_01HABC",
      "url": "https://example.com/profile",
      "domain": "example.com",
      "title": "Profile",
      "published_date": null,
      "retrieved_at": "2024-06-01T12:10:00Z",
      "method": "exa.searchAndContents",
      "snippet": "Profile snippet",
      "extracted": null,
      "source_quality": 0.74
    }
  ],
  "created_at": "2024-06-01T12:15:00Z"
}

Evidence sources

Sources represent the URLs and snippets used to evaluate claims. Use the sources array in the report or the job sources endpoint to retrieve all evidence.