---
title: "External Kit Orders Query"
method: GET
path: "/api/v3/admin/kit-orders/query"
tags: ["kit-assembly"]
---

# External Kit Orders Query

`GET /api/v3/admin/kit-orders/query`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v3/admin/kit-orders/query`
- Auth: none declared

## Query parameters

- `created_at_start_date` string, date, nullable
- `created_at_end_date` string, date, nullable
- `status` 'CREATED' | 'LABEL_CREATED' | 'LINKED' | 'SHIPPED' | 'DELIVERED' | 'REGISTERED' | 'DISCARDED' | 'ERROR'
- `search` string, nullable
- `order_by` string, nullable
- `order_direction` 'asc' | 'desc'
- `offset` integer
- `limit` integer
- `organization_identifier` string, nullable

## Response `200`

External kit orders stats

- KitOrderQueryResponseSchema[]
  - `created_at` string, date, nullable, required
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required
  - `email` string, nullable, required
  - `phone_number` integer, nullable, required
  - `status` string, nullable, required
  - `reason` string, nullable, required
  - `street_address` string, nullable, required
  - `street_address_2` string, nullable, required
  - `city` string, nullable, required
  - `state` string, nullable, required
  - `zip_code` string, nullable, required
  - `tracking_number` string, nullable, required
  - `sample_type` string, nullable, required
  - `organization` string, nullable, required
  - `order_lookup` OrderLookupSchema, required
    - `id` integer, required
    - `activation_code` string, required
    - `order_id` string, required
  - `latest_outbound_label` ShippingLabelSchema, required
    - `id` integer, required
    - `label_type` string, required
    - `carrier` string, required
    - `provider` string, required
    - `tracking_number` string, required
    - `tracking_url` string, nullable, required
  - `latest_return_label` ShippingLabelSchema, required
    - `id` integer, required
    - `label_type` string, required
    - `carrier` string, required
    - `provider` string, required
    - `tracking_number` string, required
    - `tracking_url` string, nullable, required
  - `brand` string, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)
