> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/graphql-api/api-reference/queries/orders.md).

# orders

List of orders

### Arguments

| Argument                                                                                                                  | Description                                                                            |
| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| createdSince ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Filter orders to those that where created since the given datetime.                    |
| email ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string.md))                             | Filter orders by the subscription's exact email address (case-insensitive).            |
| paid ([Boolean](https://developer.firmhouse.com/graphql-api/api-reference/objects/boolean.md))                            | Only list orders with given payment status on related invoice.                         |
| hasShopifyId ([Boolean](https://developer.firmhouse.com/graphql-api/api-reference/objects/boolean.md))                    | Filter orders by whether they have an associated Shopify order ID.                     |
| reverse ([Boolean](https://developer.firmhouse.com/graphql-api/api-reference/objects/boolean.md))                         | Reverse the sort order                                                                 |
| status ([OrderStatus](https://developer.firmhouse.com/graphql-api/api-reference/objects/order-status.md))                 | Filter orders on given status. Lists all orders if none given.                         |
| statuses (\[[OrderStatus](https://developer.firmhouse.com/graphql-api/api-reference/objects/order-status.md)!])           | Filter orders to any of these statuses. Combined with status, both filters must match. |
| updatedSince ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Filter orders to those that where updated since the given datetime.                    |
| updatedUntil ([ISO8601DateTime](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Filter orders to those that where updated until the given datetime.                    |
| orderBy ([OrderSortEnum](https://developer.firmhouse.com/graphql-api/api-reference/objects/order-sort-enum.md))           | Specify the sort order for orders. Defaults to CREATED\_AT.                            |
| shipmentDateFrom ([ISO8601Date](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date.md))      | Filter orders with a shipment date on or later than.                                   |
| shipmentDateTo ([ISO8601Date](https://developer.firmhouse.com/graphql-api/api-reference/objects/iso-8601-date.md))        | Filter orders with a shipment date on or prior to.                                     |
| after ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string.md))                             | Returns the elements in the list that come after the specified cursor.                 |
| before ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string.md))                            | Returns the elements in the list that come before the specified cursor.                |
| first ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int.md))                                   | Returns the first *n* elements from the list.                                          |
| last ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int.md))                                    | Returns the last *n* elements from the list.                                           |

### Return fields

#### edges (\[[OrderEdge](https://developer.firmhouse.com/graphql-api/api-reference/objects/order-edge.md)])

A list of edges.

#### nodes (\[[Order](https://developer.firmhouse.com/graphql-api/api-reference/objects/order.md)])

A list of nodes.

#### pageInfo ([PageInfo](https://developer.firmhouse.com/graphql-api/api-reference/objects/page-info.md)!)

Information to aid in pagination.

#### totalCount ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int.md))

The total number of items available.
