---
title: "List Unmatched Results"
method: GET
path: "/v3/unmatched_result"
tags: ["unmatched"]
---

# List Unmatched Results

`GET /v3/unmatched_result`

## Query parameters

- `limit` integer
- `next_cursor` string, nullable — The cursor for fetching the next page, or `null` to fetch the first page.
- `decision_code` 'match_sample_id' | 'match_completed' | 'match_cancelled' | 'wrong_collection' | 'wrong_lab' | 'multiple_demo_match' | 'match_sample_id_mismatch_demo' | 'match_demo' | 'no_match' — ℹ️ This enum is non-exhaustive.
- `lab_slug` string, nullable — Filter by lab slug (e.g. `labcorp`, `quest`).
- `status` 'pending_customer_review' | 'pending_ops_review' | 'resolved' — ℹ️ This enum is non-exhaustive.
- `created_at_start` string, date, nullable — Filter by result receipt date on or after this date (UTC, inclusive, YYYY-MM-DD).
- `created_at_end` string, date, nullable — Filter by result receipt date on or before this date (UTC, inclusive, YYYY-MM-DD).
- `search_input` string, nullable — Search by patient first name, last name, or date of birth (e.g. `Alice`, `Smith`, or `1990-01-15`).

## Response `200`

Successful Response

- ListUnmatchedResultResponse
  - `data` UnmatchedResult[]
    - `id` string, uuid, required
    - `status` 'matched' | 'pending_customer_review' | 'pending_ops_review' | 'resolved', required — ℹ️ This enum is non-exhaustive.
    - `decision_code` 'match_sample_id' | 'match_completed' | 'match_cancelled' | 'wrong_collection' | 'wrong_lab' | 'multiple_demo_match' | 'match_sample_id_mismatch_demo' | 'match_demo' | 'no_match', required — ℹ️ This enum is non-exhaustive.
    - `sub_reason_codes` MatchSubReasonCode[]
    - `reason` string, required
    - `patient` MatchReviewPatient
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `dob` string, date-time, nullable
      - `gender` string, nullable
    - `lab` MatchReviewLab, required
      - `id` integer, required
      - `name` string, required
      - `slug` string, required
    - `markers` MatchReviewMarker[]
      - `provider_id` string, nullable
      - `name` string, nullable
    - `interpretation` 'normal' | 'abnormal' | 'critical' | 'unknown' — ℹ️ This enum is non-exhaustive.
    - `result_status` 'final' | 'partial' — ℹ️ This enum is non-exhaustive.
    - `note` string, nullable
    - `resolution_action` 'accept' | 'reject' | 'unsure' — ℹ️ This enum is non-exhaustive.
    - `resolved_user_id` string, uuid, nullable
    - `resolved_order_id` string, uuid, nullable
    - `allowed_actions` MatchReviewResolutionAction[]
    - `candidate_groups` MatchReviewCandidateGroup[]
      - `user_id` string, uuid, nullable
      - `candidates` MatchReviewCandidate[]
        - `candidate_type` 'provenance_order' | 'order_option', required — ℹ️ This enum is non-exhaustive.
        - `order_id` string, uuid, nullable
        - `order_transaction_id` string, uuid, nullable
        - `last_status` 'ordered' | 'requisition_created' | 'requisition_bypassed' | 'transit_customer' | 'out_for_delivery' | 'with_customer' | 'transit_lab' | 'delivered_to_lab' | 'completed' | 'failure_to_deliver_to_lab' | 'failure_to_deliver_to_customer' | 'problem_in_transit_lab' | 'problem_in_transit_customer' | 'sample_error' | 'appointment_scheduled' | 'appointment_cancelled' | 'appointment_pending' | 'draw_completed' | 'cancelled' | 'lost' | 'do_not_process' | 'partial_results' | 'awaiting_registration' | 'registered' | 'redraw_available' | 'corrected' | 'lab_processing_blocked' — ℹ️ This enum is non-exhaustive.
        - `confidence_level` 'high' | 'medium' | 'low', required — ℹ️ This enum is non-exhaustive.
        - `confidence_score` number, nullable
        - `reasons` MatchCandidateReasonCode[]
        - `marker_overlap` object, nullable
        - `status_context` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `reviewed_at` string, date-time, nullable
  - `next_cursor` string, nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryvital/apis/junction-api.md) · [All operations](https://skmtc.net/tryvital/apis/junction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryvital/junction-api/revisions/034402e2bbe3/schema)