---
title: "Read bounded before-and-after previews from retained evidence"
method: GET
path: "/monitoring/inbox/{id}"
tags: ["Monitoring"]
---

# Read bounded before-and-after previews from retained evidence

`GET /monitoring/inbox/{id}`

## Request

- Base URL: `https://www.sanctionskit.com/api/v1`
- URL: `https://www.sanctionskit.com/api/v1/monitoring/inbox/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sanctionskit/apis/sanctionskit-api/docs/monitoring/inbox/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Required API key scope: results:read.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful response. JSON object with the required data key. All properties marked required are present, including keys whose value may be null. Unmarked properties can be omitted; clients should tolerate additional response properties.

- object
  - `data` MonitorEvent, required
    - `id` string, uuid, required
    - `monitorId` string, uuid, required
    - `monitorName` string, required
    - `caseId` string, uuid, nullable, required
    - `screeningId` string, uuid, nullable, required
    - `previousScreeningId` string, uuid, nullable, required
    - `kind` 'initial_match' | 'match_added' | 'match_removed' | 'evidence_changed' | 'policy_changed' | 'baseline_unavailable' | 'screening_failed' | 'screening_overdue' | 'screening_recovered' | 'review_required', required
    - `status` 'unread' | 'acknowledged', required
    - `createdAt` string, date-time, required
    - `acknowledgedAt` string, date-time, nullable, required
    - `errorCode` string, nullable, required: Public screening failure code, or null when the event does not represent an error. Infrastructure details are not returned; temporarily_unavailable and screening_failed are generic fallbacks. Unknown future codes must remain a failed or incomplete check, never no_match.
    - `totalChanges` integer, required: Total saved changes before preview limits.
    - `evidenceExpired` boolean, required: True if linked current or prior evidence is unavailable under retention; missing preview content is not proof of no change.
    - `currentEvidenceAvailable` boolean, required
    - `previousEvidenceAvailable` boolean, required
    - `changes` object[], required: Bounded change previews: at most 10 per list item or 25 on detail. Use linked retained screening IDs for complete evidence.
      - `sourceId` string, required
      - `recordId` string, required
      - `kind` 'added' | 'removed' | 'changed', required
      - `fields` string[], required
      - `before` MonitorRecordPreview: Bounded publisher-record preview. Each collection contains at most three entries; names, identifiers and designation text are shortened. Read the linked retained result for full evidence.
        - `names` object[], required
          - `value` string, required
          - `kind` 'primary' | 'alias', required
          - `quality` 'strong' | 'weak' | 'unknown'
          - `script` string
          - `provenance` SourceProvenance: Publisher field attribution. rawValue is optional; when present it preserves the original published value.
            - `sourceId` string, required
            - `recordId` string, required
            - `field` string, required
            - `rawValue` string
        - `identifiers` object[], required
          - `type` string, required
          - `value` string, required
          - `issuer` string
          - `provenance` SourceProvenance: Publisher field attribution. rawValue is optional; when present it preserves the original published value.
            - `sourceId` string, required
            - `recordId` string, required
            - `field` string, required
            - `rawValue` string
        - `birthDates` object[], required
          - `value` string, required
          - `precision` 'day' | 'month' | 'year' | 'range' | 'unknown', required
          - `original` string, required
        - `nationalities` string[], required
        - `designations` object[], required
          - `category` 'financial_sanctions' | 'export_control' | 'debarment' | 'other', required
          - `programs` string[], required
          - `legalReferences` string[], required
          - `wording` string
          - `effectiveDate` string
      - `after` MonitorRecordPreview: Bounded publisher-record preview. Each collection contains at most three entries; names, identifiers and designation text are shortened. Read the linked retained result for full evidence.
        - `names` object[], required
          - `value` string, required
          - `kind` 'primary' | 'alias', required
          - `quality` 'strong' | 'weak' | 'unknown'
          - `script` string
          - `provenance` SourceProvenance: Publisher field attribution. rawValue is optional; when present it preserves the original published value.
            - `sourceId` string, required
            - `recordId` string, required
            - `field` string, required
            - `rawValue` string
        - `identifiers` object[], required
          - `type` string, required
          - `value` string, required
          - `issuer` string
          - `provenance` SourceProvenance: Publisher field attribution. rawValue is optional; when present it preserves the original published value.
            - `sourceId` string, required
            - `recordId` string, required
            - `field` string, required
            - `rawValue` string
        - `birthDates` object[], required
          - `value` string, required
          - `precision` 'day' | 'month' | 'year' | 'range' | 'unknown', required
          - `original` string, required
        - `nationalities` string[], required
        - `designations` object[], required
          - `category` 'financial_sanctions' | 'export_control' | 'debarment' | 'other', required
          - `programs` string[], required
          - `legalReferences` string[], required
          - `wording` string
          - `effectiveDate` string

## Other responses

- `400`: **invalid_request** — Correct the request fields, resource identifiers, JSON body or query parameters before retrying.
- `401`: **authentication_required** — Send Authorization: Bearer with a valid API key. An omitted header can produce authentication_required; invalid supplied credentials produce invalid_api_key. **invalid_api_key** — Use an active key for the intended environment.
- `403`: **permission_denied** — Ask an organization owner to grant the required role or API-key scope. **insufficient_scope** — Use a key with the scope stated in this operation.
- `404`: **not_found** — Check the identifier and selected environment. The resource must belong to your organization and remain available.
- `405`: **method_not_allowed** — Use a method in the Allow response header. OPTIONS lists supported methods; HEAD follows GET authorization and returns no body.
- `413`: **response_too_large** — Reduce the requested page size or use the documented segmented case archive. No evidence is silently truncated.
- `429`: **rate_limited** — Wait for the request window to reset and retry with backoff.
- `500`: **internal_error** — Retry with backoff. For writes reuse the same idempotency key and identical input; include requestId when contacting support.
- `503`: **temporarily_unavailable** — Honor Retry-After when present and retry with bounded backoff. Follow this endpoint’s retry contract; preserve the same key and input for idempotent writes. Contact support with requestId if the failure persists.

---

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