---
title: "Retrieve a list of orders"
method: GET
path: "/v1/shops/{shop_id}/orders.json"
tags: ["Orders"]
---

# Retrieve a list of orders

`GET /v1/shops/{shop_id}/orders.json`

Retrieve a list of orders

## Query parameters

- `limit` string
- `page` string
- `status` string
- `sku` string

## Response `200`

Successful operation

- object
  - `current_page` integer
  - `data` object[]
    - `id` string
    - `app_order_id` string, nullable
    - `address_to` AddressTo
      - `first_name` string
      - `last_name` string
      - `region` string, nullable
      - `address1` string
      - `address2` string
      - `city` string
      - `zip` string
      - `email` string, email
      - `phone` string
      - `country` string
      - `company` string, nullable
    - `line_items` LineItem[]
      - `product_id` string
      - `quantity` integer
      - `variant_id` integer
      - `print_provider_id` integer
      - `cost` integer
      - `shipping_cost` integer
      - `status` string
      - `metadata` LineItemMetadata
        - `title` string
        - `price` integer
        - `variant_label` string
        - `sku` string
        - `country` string
        - `external_id` string, nullable
      - `sent_to_production_at` string, date-time, nullable
      - `fulfilled_at` string, date-time, nullable
    - `metadata` OrderMetadata
      - `order_type` string
      - `shop_order_id` integer
      - `shop_order_label` string
      - `shop_fulfilled_at` string, date-time, nullable
    - `total_price` integer
    - `total_shipping` integer
    - `total_tax` integer
    - `status` string
    - `shipping_method` integer
    - `is_printify_express` boolean
    - `is_economy_shipping` boolean
    - `shipments` Shipment[]
      - `carrier` string
      - `number` string
      - `url` string, uri
      - `delivered_at` string, date-time, nullable
    - `created_at` string, date-time
    - `sent_to_production_at` string, date-time, nullable
    - `fulfilled_at` string, date-time, nullable
    - `printify_connect` PrintifyConnect
      - `url` string, uri
      - `id` string
  - `first_page_url` string
  - `from` integer, nullable
  - `last_page` integer
  - `last_page_url` string
  - `next_page_url` string, nullable
  - `path` string
  - `per_page` integer
  - `prev_page_url` string, nullable
  - `to` integer, nullable
  - `total` integer

## Other responses

- `400` — Error response

---

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