---
title: "Bulk-update order status (any status allowed)"
method: POST
path: "/sandbox/orders/status/batch"
tags: ["Sandbox"]
---

# Bulk-update order status (any status allowed)

`POST /sandbox/orders/status/batch`

## Request

- Base URL: `https://api.physikit.com/v2`
- URL: `https://api.physikit.com/v2/sandbox/orders/status/batch`
- Auth: HTTP bearer

## Request body

- SandboxOrderChangeStatusRequest
  - `order_ids` string[], required: List of order IDs to update (sandbox accepts any valid order IDs).
  - `status` integer, required: Target order status applied to all provided orders **(sandbox only)**. Sandbox permits setting **any** status code in any direction. **Status Lifecycle (Code → Description):** - `10` → ORDERED – Order created in the system. - `11` → KIT_SHIPPED – Test kit has been shipped to the customer. - `20` → PATIENT_KIT_RECEIVED – The patient has received the test kit. - `21` → PATIENT_KIT_USED – The kit was used and prepared by the patient for return. - `22` → PATIENT_SAMPLES_SHIPPED – Samples were shipped back by the patient. - `30` → SAMPLES_RECEIVED – Samples received at the local logistics hub. - `31` → SAMPLES_SHIPPED – Samples forwarded to the lab. - `40` → LAB_SAMPLES_RECEIVED – Lab has received the samples. - `41` → LAB_SAMPLES_ANALYZED – Lab completed the analysis. - `42` → CUSTOMER_RESULTS_RETRIEVED – Results have been retrieved by the integration partner. - `98` → ARCHIVED – Order archived. - `99` → ISSUE – Order has encountered an issue.

## Response `200`

Successful Response

- OrderBatchUpdateResponse
  - `data` string[], required
  - `meta` Meta, required
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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