---
title: "Human oversight register with exceptions and overrides (Exhibits B and C)"
method: GET
path: "/api/v1/usinsurance/oversight"
tags: ["US Insurance Compliance"]
---

# Human oversight register with exceptions and overrides (Exhibits B and C)

`GET /api/v1/usinsurance/oversight`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/usinsurance/oversight`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/usinsurance/oversight/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the human oversight register for the window: approvals,
rejections, expiries and overrides, with the reviewer identity and role
the platform recorded. Rows carrying an override trail are the
exception history NAIC Supplement Exhibit C and NYDFS CL7 ask for, and
are flagged with `is_exception`.

Unreviewed rows are INCLUDED and counted in `unresolved`: how many
holds were never resolved is a market-conduct question, and filtering
them out would make every report show perfect resolution.

**Enterprise Feature**.

## Query parameters

- `period_start` string
- `period_end` string

## Headers

- `X-Org-ID` string
- `X-Tenant-ID` string

## Response `200`

Human oversight register with exceptions and overrides (Exhibits B and C)

- USInsuranceOversightResponse
  - `items` USInsuranceOversightItem[]
    - `id` string
    - `request_id` string
    - `created_at` string, date-time
    - `request_type` string
    - `trigger_reason` string
    - `policy_id` string
    - `policy_name` string
    - `severity` string
    - `status` string
    - `reviewer_id` string
    - `reviewer_role` string
    - `reviewed_at` string, date-time: Omitted when the row was never reviewed.
    - `review_latency_ms` integer: Omitted when the row was never reviewed.
    - `is_exception` boolean: True when the platform recorded the overridden status, OR recorded an override trail under another status. Both arms matter: a row carrying evidence must not drop out of the exception exhibit because its status string differs.
    - `override_authorized_by` string: Omitted when none was recorded.
    - `override_justification` string: Surfaced verbatim. Omitted when none was recorded.
  - `total` integer
  - `exceptions` integer: Count of items carrying an override trail.
  - `unresolved` integer: Count of items that were never reviewed.
  - `period_start` string, date-time
  - `period_end` string, date-time
  - `completeness` USInsuranceCompleteness: The per-response completeness signal. It is ALWAYS present, populated or not, so a client never has to infer the good case from an absent field. `unavailable` means the backing surface is not present on this deployment, which is NOT the same as an empty result.
    - `complete` boolean, required: True when the read succeeded and returned everything it matched.
    - `truncated` boolean, required: True when the row cap was reached, so the items are a subset.
    - `unavailable` boolean, required: True when the backing surface is absent on this deployment.
    - `note` string: One sentence explaining a non-complete answer. Omitted when complete.

## Other responses

- `400`: Missing organization scope (`SCOPE_REQUIRED`) or an invalid window (`INVALID_PERIOD`)
- `405`: The US insurance read routes are GET-only
- `503`: The module is not available on this deployment (`USINSURANCE_NOT_AVAILABLE`)

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)