---
title: "Create a Verification Report"
method: POST
path: "/sexoffender/report/live"
---

# Create a Verification Report

`POST /sexoffender/report/live`

Free pilot. Submit either a record UUID or a full name with supported filters. Returns immediately; poll the resource_uri. Testing/internal credentials and no-log accounts cannot create durable reports.

## Request body

- union
  - object
    - `uuid` string, uuid, required — Record UUID from Search.
    - `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.
  - object
    - `firstName` string, required
    - `lastName` string, required
    - `dob` string, date
    - `state` string
    - `city` string
    - `zipcode` string
    - `address` string
    - `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.

## Response `202`

Queued report

- AuditReportCreated
  - `report_id` string, required
  - `status` 'queued', required
  - `resource_uri` string, required

## 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.
- `429` — 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 breaking, 1 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
- **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/post.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)