---
title: "Retrieve a list of orders for the authenticated shopper. Only one filter may be used at a time"
method: GET
path: "/v1/orders"
tags: ["v1"]
---

# Retrieve a list of orders for the authenticated shopper. Only one filter may be used at a time

`GET /v1/orders`

<strong>API Resellers</strong><ul><li>This endpoint does not support subaccounts and therefore API Resellers should not supply an X-Shopper-Id header</li></ul>

## Query parameters

- `periodStart` string
- `periodEnd` string
- `domain` string
- `productGroupId` integer
- `paymentProfileId` integer
- `parentOrderId` string
- `offset` integer
- `limit` integer
- `sort` 'createdAt' | '-createdAt' | 'orderId' | '-orderId' | 'pricing.total' | '-pricing.total'

## Headers

- `X-Shopper-Id` string
- `X-App-Key` string, required

## Response `200`

Request was successful

- OrderList
  - `orders` OrderSummary[], required — A collection of orders
    - `createdAt` string, iso-datetime, required — Date and time when the current order was created
    - `currency` string, iso-currency-code, required — Currency in which the order was placed
    - `items` LineItemSummary[], required — Sets of two or more line items in current order
      - `label` string, required — Product label of the current line item
    - `orderId` string, required — Unique identifier of the current order
    - `parentOrderId` string — Unique identifier of the parent order. All refund/chargeback orders are tied to the original order. The orginal order's `orderId` is the `parentOrderId` of refund/chargeback orders
    - `pricing` OrderSummaryPricing, required
      - `total` string, currency-micro-unit, required — Total amount charged for the current order. Negative for Refund and Chargeback
  - `pagination` Pagination, required
    - `first` string — URI to access the first page
    - `last` string — URI to access the last page
    - `next` string — URI to access the next page
    - `previous` string — URI to access the previous page
    - `total` integer — Number of records available

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `429` — Too many requests received within interval
- `500` — Internal server error
- `504` — Gateway timeout

---

[API](https://skmtc.dev/godaddy/apis/untitled-api-4.md) · [All operations](https://skmtc.dev/godaddy/apis/untitled-api-4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/godaddy/untitled-api-4/revisions/037f84f629eb/schema)