---
title: "Get order"
method: GET
path: "/api/v1/orders/{id}"
tags: ["Orders"]
---

# Get order

`GET /api/v1/orders/{id}`

Retrieve an order by id.

## Path parameters

- `id` string, required

## Response `200`

The order

- OrderResponse — Represents a completed order. Orders are created after a checkout intent reaches the `completed` state.
  - `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

## Other responses

- `401` — Authentication Failed
- `404` — Not Found

---

[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)