---
title: "List orders"
method: GET
path: "/api/v1/orders"
tags: ["Orders"]
---

# List orders

`GET /api/v1/orders`

List orders for the authenticated developer with cursor-based pagination.

## Query parameters

- `limit` integer
- `after` string
- `before` string

## Response `200`

Paginated list of orders

- OrdersListResponse
  - `data` OrderResponse[], required
    - `id` string, required
    - `checkoutIntentId` string, required — ID of the checkout intent that was responsible for creating this order.
    - `createdAt` string, required — Timestamp the order was persisted to Rye.
    - `updatedAt` string, required — Timestamp the order was last updated at
    - `referenceId` string — The `referenceId` you supplied on the checkout intent, echoed back so you can reconcile this order against your own records. Absent when none was supplied.
  - `pageInfo` object, required
    - `endCursor` string
    - `startCursor` string
    - `hasPreviousPage` boolean, required
    - `hasNextPage` boolean, required

## Other responses

- `401` — Authentication Failed
- `422` — Validation Error

## Changes

- **2026-07-01** `f2236504ec75` — 1 info
  - added the optional property `data/items/referenceId` to the response with the `200` status
- **2026-06-16** `22d8a79f694f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rye-com/apis/universal-checkout-api/changes/api/v1/orders/get.md)

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/f2236504ec75/schema)