Consolidated verification / proof PDF for one search

Renders a SINGLE consolidated verification PDF for a search that was ALREADY run — pass the searchId of a prior POST /v1/search (or /v1/searches) call (valid for 7 days), optionally with the viewerName/viewerEmail of whoever is viewing it (both OPTIONAL, printed at the top as a viewer verification — not an access gate). Any valid key or session may call it — there is NO per-key entitlement. Because the search call was already billed, the report meters ONLY the +$0.02 per-PDF charge (admin-overridable per customer via pdf_rate_cents). (Legacy one-shot: omit searchId and pass an inline query, which runs the search inline and also bills the call.) The PDF shows EVERY matching offender and EVERY field on file (name, aliases, DOB/age match state, address/jurisdiction, offense/risk, photo when available, and the full extensive field set), plus a source-attribution section with a citation on every record — proving provenance. A legal notice (use restrictions; informational only, not an FCRA consumer report) is printed on the document. Responds with application/pdf as a file attachment (Content-Disposition: attachment); the report id is echoed in the X-Report-Id header. Accepts an API key OR a session token.

post/v1/report

Request

  • Base URL: https://api.offendersearch.app
  • URL: https://api.offendersearch.app/v1/report
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

searchIdstring nullable

Id of a prior /v1/search (or /v1/searches) call to report on (within the 7-day window).

jurisdictionsstring[] nullable

Legacy one-shot mode only (ignored when searchId is given).

locationScopedboolean
freshnessstring nullable

RETIRED — accept-and-ignore for one release (no tier, no surcharge). See the Regular/Live redesign.

viewerNamestring nullable

OPTIONAL — name of the person viewing/running the report (printed on the PDF).

viewerEmailstring nullable

OPTIONAL — email of the viewer (printed on the PDF).

requesterNamestring nullable

Legacy alias for viewerName (optional).

purposestring nullable

Optional stated purpose for the lookup (printed on the PDF).

referencestring nullable

Optional caller reference / case id (printed on the PDF).

Example request

{
  "searchId": "srch_9f2c1a7b3e4d",
  "query": {
    "firstName": "John",
    "lastName": "Smith",
    "dob": "1985-06-14",
    "age": 39,
    "city": "Chicago",
    "state": "IL",
    "zipcode": "60614",
    "lat": 41.9,
    "lng": -87.65
  },
  "viewerName": "Jane Doe, HR Compliance",
  "viewerEmail": "jane@acme.example",
  "purpose": "Volunteer background screening",
  "reference": "case-2026-0417"
}

Response

The consolidated verification report (a PDF file attachment).

Changes

No recorded changes to this operation across all 1 revision of this API.