---
title: "Create Unmatched Result Update"
method: POST
path: "/v3/unmatched_result/{raw_result_id}/update"
tags: ["unmatched"]
---

# Create Unmatched Result Update

`POST /v3/unmatched_result/{raw_result_id}/update`

## Request

- Base URL: `https://api.us.junction.com`
- URL: `https://api.us.junction.com/v3/unmatched_result/{raw_result_id}/update`
- Auth: API key in header `x-vital-api-key`

## Path parameters

- `raw_result_id` string, uuid, required

## Request body

- CreateUnmatchedResultUpdateBody
  - `note` string, nullable
  - `status` 'pending_customer_review' | 'pending_customer_review:in_progress': Subset of `MatchReviewTransitionStatus` a customer may move a result to. ℹ️ This enum is non-exhaustive.

## Response `200`

Successful Response

- UnmatchedResult
  - `id` string, uuid, required
  - `status` 'matched' | 'pending_customer_review' | 'pending_ops_review' | 'pending_customer_review:in_progress' | '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
    - `email` string, nullable
    - `phone_number` string, nullable
    - `address` RawResultPatientAddress
      - `first_line` string, nullable
      - `second_line` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
      - `country` 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
  - `latest_activity_actor_id` string, nullable
  - `latest_activity_actor_type` 'customer' | 'api', nullable: ℹ️ This enum is non-exhaustive.
  - `latest_activity_at` string, date-time, nullable
  - `accession_numbers` string[]
  - `raw_result_collection_dates` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `932ab14cca85`: 3 info
  - added the optional property `patient/anyOf[subschema #1: MatchReviewPatient]/address` to the response with the `200` status
  - added the optional property `patient/anyOf[subschema #1: MatchReviewPatient]/email` to the response with the `200` status
  - added the optional property `patient/anyOf[subschema #1: MatchReviewPatient]/phone_number` to the response with the `200` status
- **2026-10-14** `ea7b4c25550b`: 2 info
  - added the optional property `accession_numbers` to the response with the `200` status
  - added the optional property `raw_result_collection_dates` to the response with the `200` status
- **2026-10-09** `5b18d37e5ca5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tryvital/apis/junction-api/changes/v3/unmatched_result/:raw_result_id/update/post.md)

---

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