---
title: "List orders"
method: GET
path: "/order"
tags: ["Order"]
---

# List orders

`GET /order`

List the orders associated with the current user.

## Response `200`

List of orders.

- object
  - `data` Order[], required — List of orders.
    - `id` string, required — Unique object identifier. The format and length of IDs may change over time.
    - `index` integer — Zero-based index of the order for this user only.
    - `shipping` object, required — Shipping address of the order.
      - `name` string, required — The recipient's name.
      - `street1` string, required — Street of the address.
      - `street2` string — Apartment, suite, etc. of the address.
      - `city` string, required — City of the address.
      - `province` string — Province or state of the address.
      - `country` string, required — ISO 3166-1 alpha-2 country code of the address.
      - `zip` string, required — Zip code of the address.
      - `phone` string — Phone number of the recipient.
    - `amount` object, required — The subtotal and shipping amounts of the order.
      - `shipping` integer, required — Shipping amount of the order, in cents (USD).
      - `subtotal` integer, required — Subtotal amount of the order, in cents (USD).
    - `tracking` object, required — Tracking information of the order.
      - `service` string — Shipping service of the order.
      - `number` string — Tracking number of the order.
      - `url` string — Tracking URL of the order.
    - `items` OrderItem[], required — Items in the order.
      - `id` string, required — Unique object identifier. The format and length of IDs may change over time.
      - `description` string — Description of the item in the order.
      - `amount` integer, required — Amount of the item in the order, in cents (USD).
      - `quantity` integer, required — Quantity of the item in the order.
      - `productVariantID` string — ID of the product variant of the item in the order.

## Other responses

- `401` — Unauthorized - Authentication is required and has failed or has not been provided.
- `429` — Too Many Requests - You have made too many requests in a short period of time.
- `500` — Internal Server Error - Something went wrong on our end.

## Changes

- **2025-03-07** `979a6c40552c` — 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2024-12-16** `56a8a6f18e6c` — 1 info
  - endpoint added
- **2024-12-16** `021e5a9aa9e2` — 1 breaking
  - api path removed without deprecation
- **2024-12-13** `916cf9100f68` — 1 breaking, 9 info
  - the `data/items/shipping` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/shipping/phone` to the response with the `200` status
  - added the optional property `data/items/shipping/province` to the response with the `200` status
  - added the optional property `data/items/shipping/street2` to the response with the `200` status
  - …6 more
- **2024-12-13** `43ff7af31b1e` — 1 breaking, 3 info
  - removed the required property `result` from the response with the `200` status
  - api operation id `getOrder` was added
  - api tag `Orders` added
  - added the required property `data` to the response with the `200` status

[Change history](https://skmtc.dev/terminaldotshop/apis/terminal-api/changes/order/get.md)

---

[API](https://skmtc.dev/terminaldotshop/apis/terminal-api.md) · [All operations](https://skmtc.dev/terminaldotshop/apis/terminal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminaldotshop/terminal-api/revisions/cb50019f2425/schema)