---
title: "Poll or retrieve a Verification Report"
method: GET
path: "/sexoffender/report/live/{reportId}"
---

# Poll or retrieve a Verification Report

`GET /sexoffender/report/live/{reportId}`

Queued/running/failed resources remain JSON status resources. Completed resources include the full immutable snapshot and signed manifest. Ownership mismatch returns opaque 404.

## Path parameters

- `reportId` string, required

## Response `200`

Current status or completed report

- AuditReportResource
  - `report_id` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed', required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time
  - `resource_uri` string — Present for queued, running and failed resources.
  - `failure_code` string — Present when failed.
  - `message` string
  - `action` string
  - `snapshot_sha256` string
  - `pdf_sha256` string
  - `pdf_uri` string — Present when completed.
  - `request_metadata` AuditReportRequestMetadata — Optional customer-provided and unverified context. Authenticated caller identity remains in existing system audit records. This private metadata is bound to the signed snapshot, excluded from account lists and public receipts, and is not a compliance determination.
    - `purpose` string — Free-form purpose; trimmed and omitted if empty.
    - `reference` string — Free-form customer reference; trimmed and omitted if empty.
    - `requested_by` string — Customer-asserted requester, facility, department, user, or system; not an authenticated Offenders.io actor.
    - `include_in_pdf` boolean — Print non-empty context on the PDF when true; defaults to false.
  - `snapshot` object — Complete immutable evidence snapshot, present when completed.
  - `signed_manifest` object — Signed hashes and report metadata, present when completed.

## Other responses

- `400` — Error with an actionable next step. Unknown or other-account reports return opaque 404.
- `401` — Error with an actionable next step. Unknown or other-account reports return opaque 404.
- `403` — Error with an actionable next step. Unknown or other-account reports return opaque 404.
- `404` — Error with an actionable next step. Unknown or other-account reports return opaque 404.
- `503` — Error with an actionable next step. Unknown or other-account reports return opaque 404.

## Changes

- **2026-09-27** `3839b7742c8a` — 1 info
  - added the optional property `request_metadata` to the response with the `200` status
- **2026-09-26** `a647e84e9275` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/changes/sexoffender/report/live/:reportId/get.md)

---

[API](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api.md) · [All operations](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/revisions/3839b7742c8a?raw)