---
id: orders
title: orders
---

Lists orders, including discards where supported. Requires orders:read.

```graphql
orders(
  after: String
  filter: OrderFilter
  first: Int = 100
  updatedSince: DateTime
): OrderCollection!
```

### Arguments

#### [`orders.after`](#after) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#after}

Opaque cursor from the previous page of this collection and filter.

#### [`orders.filter`](#filter) · [`OrderFilter`](/docs/developers/api-reference/management/v1/types/inputs/order-filter) **input** {#filter}

Optional record and relationship filters.

#### [`orders.first`](#first) · [`Int`](/docs/developers/api-reference/management/v1/types/scalars/int) **scalar** {#first}

Page size, clamped to 1–100.

#### [`orders.updatedSince`](#updated-since) · [`DateTime`](/docs/developers/api-reference/management/v1/types/scalars/date-time) **scalar** {#updated-since}

Inclusive modification timestamp for synchronization.

### Type

#### [`OrderCollection`](/docs/developers/api-reference/management/v1/types/objects/order-collection) **object**

A page of orders with continuation information.