---
title: "Upload a CSV to change order status"
method: POST
path: "/v3/orders/upload-change-status"
tags: ["Orders"]
---

# Upload a CSV to change order status

`POST /v3/orders/upload-change-status`

Requires the `order:change_status` scope. Upload a CSV file to change status of multiple orders. Template file can be downloaded from the link here: https://app.scalev.id/example/update_status_template.csv. (1) Leave blank the 'shipment_receipt' field if you don't want to change the receipt/tracking number. Note: this will not change receipts/tracking numbers that are automatically generated by Scalev through the 'Request Pickup' menu. (2) Leave blank the 'day', 'month', and 'year' fields if you want to use the time of upload.

## Response `200`

Status changed successfully

- ChangeOrderStatusResponseBody — Non-paginated list payload for v3.
  - `data` OrderChangeStatus[], required
    - `id` string, uuid — Canonical UUIDv7 order primary key returned by the partitioned orders table.
    - `order_id` string — Order ID in string format
    - `public_order_url` string, uri, nullable — Public order URL built from metadata.custom_domain_full_url and secret_slug.
    - `payment_url` string, uri, nullable — Payment URL built from public_order_url with /success appended.
    - `payment_status` 'unpaid' | 'paid' | 'conflict' | 'settled' — Order payment status
    - `status` 'draft' | 'pending' | 'confirmed' | 'in_process' | 'ready' | 'shipped' | 'completed' | 'canceled' | 'rts' | 'closed' — Order status
  - `is_paginated` false, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/730030bd6477/schema)