Skip to main content

Case Anomalies

List anomalies detected within a case with severity filtering and dismissed toggle. Dismiss individual anomalies after review.

Anomalies are structural issues detected across the documents in a case — field conflicts, duplicate key divergence, value reuse patterns, and more.

Five structural detectors run automatically when cases are materialized. They surface inconsistencies that may indicate data quality issues, duplicate submissions, or missing documents within a case.

GET/v1/cases/:key/anomalies

Response

Response fields

dataarrayArray of anomaly objects.
data[].idstringAnomaly UUID.
data[].typestringAnomaly detector type (e.g. field_conflict, duplicate_key_divergence, value_reuse, missing_document_type, validation_cluster).
data[].severitystringSeverity level: low, medium, high, or critical.
data[].descriptionstringHuman-readable description of the anomaly.
data[].dismissedbooleanWhether this anomaly has been dismissed.
data[].created_atstringISO 8601 timestamp when the anomaly was detected.

Response

{
  "data": [
    {
      "id": "anom_uuid_1",
      "type": "field_conflict",
      "severity": "high",
      "description": "Conflicting vendor_name across 3 documents",
      "dismissed": false,
      "created_at": "2024-10-02T10:00:00.000Z"
    }
  ]
}
PATCH/v1/cases/:key/anomalies/:id/dismiss

Response

Response fields

dismissedbooleanAlways true on success.

Response

{ "dismissed": true }

Errors

Error responses

400bad_requestInvalid case key format.
401unauthorizedMissing or invalid API key.
404not_foundCase or anomaly not found.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Get Case
Case Operations