---
title: "List mismatch observations"
method: GET
path: "/mismatch-observations"
tags: ["Mismatch alerts"]
---

# List mismatch observations

`GET /mismatch-observations`

Returns mismatch observations for the authenticated customer only, ordered from newest to oldest. Paginated; default page size is 50. Returns 200 with an empty `mismatch_observations` array when none exist.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Paginated list of mismatch observations for the customer.

- MismatchObservationsListResponse
  - `mismatch_observations` MismatchObservationItem[], required
    - `id` string, uuid, required — Alert row identifier.
    - `alert_name` string, nullable — Optional display name; may be null if not set.
    - `usdot` string, nullable, required — USDOT value from stored criteria.
    - `mc` string, nullable, required — MC value from stored criteria.
    - `logos` string[] — Trailer logos from `logos`, returned in normalized lowercase format. Empty when not configured.
    - `is_disabled` boolean, required — Whether this mismatch observation alert is disabled.
    - `created_at` string, date-time, nullable — Creation timestamp when available.
    - `last_run_at` string, date-time, nullable — Last run timestamp in ISO-8601 format; null when not run yet.
  - `page` integer, required — Current page number.
  - `page_size` integer, required — Page size used for this response.
  - `total` integer, required — Total number of observations for this customer (all pages).

## Other responses

- `401` — Unauthorized – Invalid or missing Access-Token.
- `403` — Forbidden – missing permission.

---

[API](https://skmtc.dev/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.dev/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/revisions/bf34c2431a21/schema)