---
title: "orders"
method: GET
path: "/v1/orders/{order_reference_id}"
tags: ["v1", "Orders"]
---

# orders

`GET /v1/orders/{order_reference_id}`

Get details and check the status of an existing order

## Path parameters

- `order_reference_id` string, required

## Query parameters

- `include-shipping-info` boolean

## Response `200`

Successful Operation

- object
  - `created_at` string, date-time — The date the session was created in ISO 8601 date/time format
  - `captured_at` string, date-time — The date the order was captured in ISO 8601 date/time format
  - `capture_expiration` string, date-time — The date until which the merchant can capture the order amount. ISO 8601 date/time format
  - `description` string — Your description for this order
  - `amount_in_cents` number — The total order amount in cents in original merchant currency
  - `usd_amount_in_cents` number — The total order amount in cents converted to USD
  - `customer_amount_in_cents` number — The total order amount in cents converted to customer currency
  - `currency_code` string — The original merchant 3 character currency code as defined by ISO 4217
  - `customer_currency_code` string — The customer's 3 character currency code as defined by ISO 4217
  - `reference_id` string — The checkout or cart ID from the merchant, currently used for tracking only (must contain only alphanumeric characters, dashes (-), and underscores (_))
  - `shipping_address` AddressV1
    - `name` string — The name on the address
    - `street` string — The street and number of the address
    - `street2` string — The apt or unit
    - `city` string — The city
    - `state` string — The 2 character state code
    - `postal_code` string — The postal delivery code
    - `country_code` string — The 2 character country code
    - `phone_number` string — The phone number at the delivery location
  - `billing_address` AddressV1
    - `name` string — The name on the address
    - `street` string — The street and number of the address
    - `street2` string — The apt or unit
    - `city` string — The city
    - `state` string — The 2 character state code
    - `postal_code` string — The postal delivery code
    - `country_code` string — The 2 character country code
    - `phone_number` string — The phone number at the delivery location
  - `customer` object — The customer's basic contact information
    - `first_name` string — The customer's first name
    - `last_name` string — The customer's last name
    - `email` string — The customer's email address
    - `phone` string — The customer's phone number
  - `refunds` object[] — Refunded funds event detail
    - `amount` Price
      - `amount_in_cents` integer, required — The amount in cents
      - `currency` string, required — The 3 character currency code as defined by ISO 4217
    - `created_at` string, date-time — The UTC time and date when the refund was issued
    - `is_full_refund` boolean — Whether the transaction is the full amount of the order
    - `order_reference_id` string — The checkout or cart ID from the merchant, currently used for tracking only (must contain only alphanumeric characters, dashes (-), and underscores (_))
    - `refund_id` string — UUID for the Refund. Must be unique to a Merchant
    - `refund_reason` string — A reason for the refund
  - `metadata` object — Object for any custom data you want to submit with the checkout. You are not limited to the key-value pairs shown in the example, and you may use any key-value pairs you like
    - `any` string — Custom metadata field
  - `items` LineItemBasic[] — The items being purchased
    - `name` string — The name of the item
    - `sku` string — The sku identifier
    - `quantity` integer — The quantity purchased
    - `price` Price
      - `amount_in_cents` integer, required — The amount in cents
      - `currency` string, required — The 3 character currency code as defined by ISO 4217
    - `category_path` string — The category path where the product is located. Use `>` only as the category delimiter, not as part of a product or category name. Example: Camping Gear & Supplies > Tents & Shelters.
  - `checkout_expiration` string, date-time — The date until which the shopper can access the checkout_url generated in Create Session request to complete the order. ISO 8601 date/time format

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — The specified resource was not found
- `422` — Unable to process the request entity

---

[API](https://skmtc.dev/sezzle/apis/sezzle-api-v2.md) · [All operations](https://skmtc.dev/sezzle/apis/sezzle-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sezzle/sezzle-api-v2/revisions/878c32abbb37/schema)