---
title: "List Prematch Orders"
method: GET
path: "/orders/prematch/all"
tags: ["Prematch"]
---

# List Prematch Orders

`GET /orders/prematch/all`

Get a list of all prematch orders.

## Headers

- `version-datavant` string — Version of the Orders API to use with this call

## Response `200`

Successful Response

- PrematchOrderResponse[]
  - `uuid` string, uuid4, required — Unique identifier for the object.
  - `id` string, required — User-provided identifier for the object. * Must be between 4 and 32 characters * Must contain only upper or lower-case alphanumeric characters, numbers, hyphens and/or underscores.
  - `name` string — User-friendly name for the order.
  - `type` 'attorney' | 'datavant' | 'disability' | 'continuing_care' | 'copya' | 'copyi' | 'facility' | 'government' | 'insurance' | 'patient' | 'payd' | 'payi' | 'pro' | 'fac', required — An enumeration.
  - `status` string, required — Current status of the order.
  - `created_at` string, date-time, required — The ISO8601 formatted timestamp for when the object was created.
  - `validation_results` OrderValidationResponse — Order validation results.
    - `valid` integer, required — Number of validated rows.
    - `failed` integer, required — Number of failed rows.
    - `copied` integer, required — Number of copied rows.
    - `in_progress` integer, required — Number of in progress rows. -1 if not calculated yet.
    - `validation_failures_threshold` integer — Max failure percent to dispatch with validation errors by default.
    - `tenant_name` string — Tenant name.
  - `roster_id` string — Roster ID for the order.
  - `filename` string — Roster file name.
  - `total_queries` integer, required — Total queries for this order
  - `created_by` string — User who created the order
  - `retrieval_sources` string[] — Retrieval sources for the order
  - `match_reasons_documents` object — Map of match reason document types to their IDs

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

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