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

# Get a specific order

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

## Path parameters

- `id` integer, required

## Response `200`

order found

- object
  - `order` object, required
    - `id` integer, required — Identifier for this order
    - `full_id` string, required — Full ID for this order, including prefix
    - `catalog_id` integer, required — DEPRECATED: use catalog['id'] instead
    - `catalog` object, required — Catalog the order is linked to
      - `id` integer, required — Identifier for the catalog the order is linked to
      - `name` string, required — Name of the catalog this order is linked to
    - `user` object, required — User who placed the order
      - `id` integer, required — Canvas ID of the user who placed the order
      - `name` string, required — Name of the user who placed the order
      - `email` string, required — E-mail address of the user who placed the order
    - `listings` object[], required — Purchased listings (courses and programs)
      - `id` integer, required — Identifier for a listing purchased with this order
      - `canvas_course_id` integer, required — Canvas course ID for this listing (null for programs)
      - `title` string, required — The name of the listing
      - `amount` string, required — Listing price at the time of purchase (decimal)
      - `discounted_amount` string, required — Discounted price after promotions (decimal)
      - `catalog_id` integer, required — Catalog ID associated to this listing
    - `promotions` object[], required — Promotions used
      - `id` integer, required — Identifier for a promotion used with this order
      - `listing_id` integer, required — Identifier for the listing this promotion is used for
      - `code` string, required — Promo code used for this order
      - `amount` string, required — Discount amount (decimal)
    - `payments` object[], required — Payments
      - `reference_id` string, required — Identifier from the payment redirector
      - `status` string, required — Status of the payment: success, error, or pending
      - `amount` string, required — Amount of the payment (decimal)
    - `total` string, required — Total cost charged to the user (decimal)
    - `currency` string, required — Currency used for the transaction
    - `purchased_at` string, nullable, required — Time the transaction completed successfully; null for unsuccessful or unpaid orders
    - `created_at` string, required — Time the order was initiated

---

[API](https://skmtc.net/instructure/apis/canvas-catalog-api.md) · [All operations](https://skmtc.net/instructure/apis/canvas-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/canvas-catalog-api/revisions/78578cd3e37a/schema)