---
title: "Upload orders from a file"
method: POST
path: "/v3/orders/upload"
tags: ["Orders"]
---

# Upload orders from a file

`POST /v3/orders/upload`

Requires the `order:create` scope. Upload orders from CSV file. (1) Archive mode. Choose this mode if you want to import old data from another platform you've been using. You can directly create products that you made on your previous platform. Orders that are created will immediately have 'Completed' status. Download template for Archive mode here: https://app.scalev.id/example/template_archive.csv. (2) Regular mode. Choose this mode if you want to enter current data that you wish to input in bulk, not one by one via order input. It will take inventory into account if your products have inventory enabled. Successfully created orders will have 'Created', 'Pending', or 'Confirmed' status, depending on the completeness of the data. Download template for Regular mode here: https://app.scalev.id/example/template_regular.csv.

## Response `200`

Orders uploaded successfully

- UploadOrders
  - `failed` object
    - `ID_OF_ORDER` string — Error for the order with this ID
  - `success` object[]
    - `external_id` string, nullable — External ID of the order
    - `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

## 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/versions/4354959d76dc/schema)