---
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.
    - `cancellation` union, required
      - RequestedCancellation
        - `reason` CancellationReason, required
          - `message` string — Optional free-text note explaining the cancellation, forwarded to the merchant when possible.
          - `code` 'requested_by_customer' | 'fraud' | 'inventory' | 'payment_issue' | 'staff_error' | 'other', required
        - `marketplaceOrderId` string, required
        - `checkoutIntentId` string, required
        - `createdAt` string, date-time, required
        - `id` string, required
        - `state` 'requested', required
      - CompletedCancellation
        - `reason` CancellationReason, required
          - `message` string — Optional free-text note explaining the cancellation, forwarded to the merchant when possible.
          - `code` 'requested_by_customer' | 'fraud' | 'inventory' | 'payment_issue' | 'staff_error' | 'other', required
        - `marketplaceOrderId` string, required
        - `checkoutIntentId` string, required
        - `createdAt` string, date-time, required
        - `id` string, required
        - `state` 'completed', required
      - DeniedCancellation
        - `reason` CancellationReason, required
          - `message` string — Optional free-text note explaining the cancellation, forwarded to the merchant when possible.
          - `code` 'requested_by_customer' | 'fraud' | 'inventory' | 'payment_issue' | 'staff_error' | 'other', required
        - `marketplaceOrderId` string, required
        - `checkoutIntentId` string, required
        - `createdAt` string, date-time, required
        - `id` string, required
        - `denialReason` CancellationDenialReason, required
          - `code` 'other' | 'already_shipped' | 'non_cancellable_item' | 'cancellation_window_expired', required
          - `message` string, required
        - `state` 'denied', required
  - `pageInfo` object, required
    - `endCursor` string
    - `startCursor` string
    - `hasPreviousPage` boolean, required
    - `hasNextPage` boolean, required

## Other responses

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

---

[API](https://skmtc.net/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.net/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/versions/64dd95f8c66b/schema)