Skip to main content
Understanding the Report
  • score: Overall verification score (0-100)
  • score_breakdown: Scores by category (identity, employment, education, business)
  • identity_resolution: How well we matched the person
  • claims: Individual claim verification results
  • sources: All evidence used in verification
Each claim includes an explanation field describing why it was verified or not.
GET
/
v1
/
jobs
/
{job_id}
/
report
Get a report
curl --request GET \
  --url https://api.peepal.dev/v1/jobs/{job_id}/report \
  --header 'x-api-key: <api-key>'
{
  "job_id": "<string>",
  "status": "<unknown>",
  "score": 50,
  "score_breakdown": {
    "identity": 50,
    "employment": 50,
    "education": 50,
    "business": 50
  },
  "identity_resolution": {
    "status": "matched",
    "confidence": 0.5,
    "candidates": [
      {
        "label": "<string>",
        "confidence": 0.5,
        "profile_urls": [
          "<string>"
        ]
      }
    ]
  },
  "claims": [
    {
      "claim_key": "<string>",
      "claim_type": "education",
      "status": "verified",
      "confidence": 0.5,
      "evidence": [
        {
          "source_id": "<string>"
        }
      ],
      "explanation": "<string>",
      "matched_value": {}
    }
  ],
  "sources": [
    {
      "source_id": "<string>",
      "url": "<string>",
      "domain": "<string>",
      "retrieved_at": "2023-11-07T05:31:56Z",
      "method": "exa.searchAndContents",
      "title": "<string>",
      "published_date": "<string>",
      "snippet": "<string>",
      "extracted": {},
      "source_quality": 0.5
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "warnings": [
    "<string>"
  ],
  "metadata": {}
}
Retrieve the verification report for a completed job. This includes the overall score, claim results, identity resolution, and all evidence sources.

​
Report Availability

Reports are only available for jobs with status: "completed". Attempting to fetch a report for an incomplete job will return a 409 Conflict error. 
curl -X GET "https://api.peepal.dev/v1/jobs/job_01ARZ3NDEKTSV4RRFFQ69G5FAV/report" \
  -H "x-api-key: YOUR_API_KEY"

{
  "job_id": "job_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "status": "completed",
  "score": 85,
  "score_breakdown": {
    "identity": 92,
    "employment": 88,
    "education": 75,
    "business": 0
  },
  "identity_resolution": {
    "status": "matched",
    "confidence": 0.92,
    "candidates": [
      {
        "label": "Ada Lovelace - University of London",
        "confidence": 0.92,
        "profile_urls": [
          "https://www.linkedin.com/in/ada-lovelace"
        ]
      }
    ]
  },
  "claims": [
    {
      "claim_key": "edu_1",
      "claim_type": "education",
      "status": "verified",
      "confidence": 0.85,
      "matched_value": {
        "school": "University of London",
        "degree": "Mathematics"
      },
      "evidence": [
        {"source_id": "src_01ARZ3NDEKTSV4RRFFQ69G5FAX"}
      ],
      "explanation": "Found clear evidence on LinkedIn profile and university records"
    }
  ],
  "sources": [
    {
      "source_id": "src_01ARZ3NDEKTSV4RRFFQ69G5FAX",
      "url": "https://www.linkedin.com/in/ada-lovelace",
      "domain": "linkedin.com",
      "title": "Ada Lovelace | LinkedIn",
      "retrieved_at": "2025-12-31T10:01:15Z",
      "method": "exa.searchAndContents"
    }
  ],
  "warnings": [],
  "created_at": "2025-12-31T10:02:30Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
job_id
string
required

Response

Report details

​
job_id
string
required
​
status
any
required
​
score
integer
required
Required range: 0 <= x <= 100
​
score_breakdown
object
required
​
identity_resolution
object
required
​
claims
object[]
required
​
sources
object[]
required
​
created_at
string<date-time>
required
​
warnings
string[]
​
metadata
object