---
title: "Read match decisions, assignments, retained notes and attachment metadata"
method: GET
path: "/investigations/{id}"
tags: ["Review evidence"]
---

# Read match decisions, assignments, retained notes and attachment metadata

`GET /investigations/{id}`

## Request

- Base URL: `https://www.sanctionskit.com/api/v1`
- URL: `https://www.sanctionskit.com/api/v1/investigations/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sanctionskit/apis/sanctionskit-api/docs/investigations/: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` Investigation, required
    - `id` string, uuid, required
    - `screeningId` string, uuid, required
    - `counterpartyId` string, uuid, nullable, required
    - `decision` 'open' | 'confirmed' | 'dismissed', required
    - `revision` integer, required
    - `assigneeId` string, nullable, required
    - `priority` 'low' | 'normal' | 'high' | 'urgent', required
    - `dueAt` string, date-time, nullable, required
    - `escalatedAt` string, date-time, nullable, required
    - `requiresSecondReview` boolean, required
    - `reviewState` 'open' | 'pending_approval' | 'approved' | 'superseded', required
    - `businessDisposition` 'pending' | 'allow' | 'restrict' | 'escalate', required
    - `reviewStartedAt` string, date-time, required
    - `supersededByScreeningId` string, uuid, nullable, required
    - `supersededByCaseId` string, uuid, nullable, required
    - `approvalRequiredByPolicy` boolean, required
    - `approvalRequiredForActions` string[], required
    - `approverRoles` string[], required
    - `reviewConcern` string, nullable, required
    - `policyContext` object, nullable, required
      - `id` string, uuid, required
      - `version` integer, required
      - `name` string, required
      - `purpose` string, required
      - `exclusions` string[], required
    - `decisionHistory` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, nullable, required
      - `decision` 'open' | 'confirmed' | 'dismissed', required
      - `businessDisposition` 'pending' | 'allow' | 'restrict' | 'escalate', nullable, required
      - `rationale` string, nullable, required
      - `actorId` string, required
      - `actorLabel` string, nullable, required
      - `createdAt` string, date-time, required
      - `appliedControls` AppliedDecisionControls, required: Immutable decision-time approval configuration. A null appliedControls value on a decision means no historic snapshot is available; current settings are never substituted. Notification recipients and document hosts are excluded.
        - `governanceRevision` integer, required
        - `organizationApproval` object, required
          - `requireSecondReview` boolean, required
          - `secondReviewFor` string[], required
          - `approverRoles` string[], required
        - `restrictedRoles` object, required
          - `approval` string[], required
          - `production` string[], required
        - `screeningPolicy` object, nullable, required
          - `id` string, uuid, required
          - `version` integer, required
          - `review` object, required
            - `requireSecondReview` boolean, required
            - `secondReviewFor` string[], required
            - `approverRoles` string[], required
    - `decisionHistoryTruncated` boolean, required
    - `checks` object[], required
      - `label` string, required
      - `instructions` string
      - `evidenceExample` string
      - `reviewConcern` string
      - `status` 'outstanding' | 'completed_externally' | 'not_applicable', required
      - `evidenceReference` string, required
      - `rationale` string, required
      - `actorId` string, nullable, required
      - `updatedAt` string, date-time, nullable, required
    - `checkHistory` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, required
      - `label` string, required
      - `status` 'outstanding' | 'completed_externally' | 'not_applicable', required
      - `evidenceReference` string, required
      - `rationale` string, required
      - `actorId` string, required
      - `updatedAt` string, date-time, required
      - `expiresAt` string, date-time, nullable, required
    - `reuseChallenges` object[], required
      - `ruleId` string, required
      - `originCaseId` string, required
      - `challengedByCaseId` string, required
      - `actorId` string, required
      - `revokedAt` string, date-time, required
      - `affectedCaseIds` string[], required
    - `submittedBy` string, nullable, required
    - `approvedBy` string, nullable, required
    - `matches` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, required
      - `sourceId` string, required
      - `recordId` string, required
      - `identityDecision` 'unresolved' | 'same' | 'different', required
      - `businessDecision` 'pending' | 'allow' | 'restrict' | 'escalate', required
      - `rationale` string, required
      - `reusableUntil` string, date-time, nullable, required
      - `reusedRuleId` string, uuid, nullable, required
      - `actorId` string, required
      - `updatedAt` string, date-time, required
      - `reuse` object
        - `caseId` string, uuid, required
        - `screeningId` string, uuid, required
        - `approvedBy` string, required
        - `expiresAt` string, date-time, required
        - `revokedAt` string, date-time, nullable, required
    - `subject` Subject, required
      - `name` string, required: Name to compare with publisher records. Leading and trailing whitespace is removed; provide the fullest reliable name available.
      - `entityType` 'person' | 'organization' | 'vessel' | 'aircraft' | 'other': Type of subject. Defaults to person when omitted. Every selected source must support this type.
      - `identifiers` object[]: Typed identifiers used for exact matching, such as passport, national_id, registration, lei, imo or mmsi. Defaults to an empty array. Use the publisher’s identifier scheme; custom scheme names are accepted.
        - `type` string, required: Identifier scheme, such as passport, national_id, registration, lei, imo or mmsi. Matching normalizes supported scheme aliases.
        - `value` string, required: Identifier value. Send the original value; scheme-specific normalization is applied during matching.
        - `issuer` string: Optional issuing authority or country. Omit when unknown; do not send null.
      - `birthDate` union: Known date or partial date: YYYY, YYYY-MM or YYYY-MM-DD. Preserve known precision; do not invent a month or day. Year 0000 and invalid dates are rejected.
        - string
        - string
      - `country` string: Known country name or code used as supporting identity evidence. It is not a source-selection or geographic coverage filter.
    - `counterpartySubject` Subject, required
      - `name` string, required: Name to compare with publisher records. Leading and trailing whitespace is removed; provide the fullest reliable name available.
      - `entityType` 'person' | 'organization' | 'vessel' | 'aircraft' | 'other': Type of subject. Defaults to person when omitted. Every selected source must support this type.
      - `identifiers` object[]: Typed identifiers used for exact matching, such as passport, national_id, registration, lei, imo or mmsi. Defaults to an empty array. Use the publisher’s identifier scheme; custom scheme names are accepted.
        - `type` string, required: Identifier scheme, such as passport, national_id, registration, lei, imo or mmsi. Matching normalizes supported scheme aliases.
        - `value` string, required: Identifier value. Send the original value; scheme-specific normalization is applied during matching.
        - `issuer` string: Optional issuing authority or country. Omit when unknown; do not send null.
      - `birthDate` union: Known date or partial date: YYYY, YYYY-MM or YYYY-MM-DD. Preserve known precision; do not invent a month or day. Year 0000 and invalid dates are rejected.
        - string
        - string
      - `country` string: Known country name or code used as supporting identity evidence. It is not a source-selection or geographic coverage filter.
    - `counterpartyRevision` integer, nullable, required
    - `originCorrection` object, nullable, required
      - `caseId` string, uuid, required
      - `screeningId` string, uuid, required
    - `evidence` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, required
      - `sourceId` string, required
      - `recordId` string, required
      - `field` string, required
      - `value` string, required
      - `sourceReference` string, required
      - `verification` 'unverified' | 'verified', required
      - `comparison` 'agrees' | 'conflicts' | 'unknown', required
      - `notes` string, required
      - `content` string, required
      - `actorId` string, required
      - `createdAt` string, date-time, required
      - `expiresAt` string, date-time, nullable, required
    - `corrections` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, required
      - `resultScreeningId` string, uuid, required
      - `resultCaseId` string, uuid, nullable, required
      - `before` Subject, required
        - `name` string, required: Name to compare with publisher records. Leading and trailing whitespace is removed; provide the fullest reliable name available.
        - `entityType` 'person' | 'organization' | 'vessel' | 'aircraft' | 'other': Type of subject. Defaults to person when omitted. Every selected source must support this type.
        - `identifiers` object[]: Typed identifiers used for exact matching, such as passport, national_id, registration, lei, imo or mmsi. Defaults to an empty array. Use the publisher’s identifier scheme; custom scheme names are accepted.
          - `type` string, required: Identifier scheme, such as passport, national_id, registration, lei, imo or mmsi. Matching normalizes supported scheme aliases.
          - `value` string, required: Identifier value. Send the original value; scheme-specific normalization is applied during matching.
          - `issuer` string: Optional issuing authority or country. Omit when unknown; do not send null.
        - `birthDate` union: Known date or partial date: YYYY, YYYY-MM or YYYY-MM-DD. Preserve known precision; do not invent a month or day. Year 0000 and invalid dates are rejected.
          - string
          - string
        - `country` string: Known country name or code used as supporting identity evidence. It is not a source-selection or geographic coverage filter.
      - `after` Subject, required
        - `name` string, required: Name to compare with publisher records. Leading and trailing whitespace is removed; provide the fullest reliable name available.
        - `entityType` 'person' | 'organization' | 'vessel' | 'aircraft' | 'other': Type of subject. Defaults to person when omitted. Every selected source must support this type.
        - `identifiers` object[]: Typed identifiers used for exact matching, such as passport, national_id, registration, lei, imo or mmsi. Defaults to an empty array. Use the publisher’s identifier scheme; custom scheme names are accepted.
          - `type` string, required: Identifier scheme, such as passport, national_id, registration, lei, imo or mmsi. Matching normalizes supported scheme aliases.
          - `value` string, required: Identifier value. Send the original value; scheme-specific normalization is applied during matching.
          - `issuer` string: Optional issuing authority or country. Omit when unknown; do not send null.
        - `birthDate` union: Known date or partial date: YYYY, YYYY-MM or YYYY-MM-DD. Preserve known precision; do not invent a month or day. Year 0000 and invalid dates are rejected.
          - string
          - string
        - `country` string: Known country name or code used as supporting identity evidence. It is not a source-selection or geographic coverage filter.
      - `reason` string, required
      - `actorId` string, required
      - `createdAt` string, date-time, required
      - `expiresAt` string, date-time, nullable, required
    - `reviewHistory` object[], required
      - `id` string, uuid, required
      - `screeningId` string, uuid, required
      - `sourceId` string, required
      - `recordId` string, required
      - `review` object, required
        - `id` string, uuid, required
        - `screeningId` string, uuid, required
        - `sourceId` string, required
        - `recordId` string, required
        - `identityDecision` string, required
        - `businessDecision` string, required
        - `rationale` string, required
        - `reusableUntil` string, date-time, nullable, required
        - `reusedRuleId` string, uuid, nullable, required
        - `actorId` string, required
        - `updatedAt` string, date-time, required
      - `replacedBy` string, required
      - `reason` 'decision_updated' | 'evidence_added' | 'subject_corrected' | 'rule_challenged', required
      - `createdAt` string, date-time, required
      - `expiresAt` string, date-time, nullable, required
    - `comments` object[], required
      - `id` string, uuid, required
      - `body` string, required
      - `actorId` string, required
      - `createdAt` string, date-time, required
    - `attachments` object[], required
      - `id` string, uuid, required
      - `title` string, required
      - `sha256` string, required
      - `size` integer, required
      - `actorId` string, required
      - `createdAt` string, date-time, required
      - `expiresAt` string, date-time, nullable, required
    - `assignees` object[], required
      - `id` string, required
      - `email` string, required
      - `role` string, required

## 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. **investigation_too_large** — Use the complete segmented case archive for retained evidence.
- `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)