---
title: "Get order by id"
method: GET
path: "/open-api/v1.0/order/{orderId}"
tags: ["Orders"]
---

# Get order by id

`GET /open-api/v1.0/order/{orderId}`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Returns order by id

## Path parameters

- `orderId` string, required

## Response `200`

OK

- ComFourthwallOpenapiModelOrderV1
  - `id` string, required
  - `shopId` string, required
  - `friendlyId` string, required
  - `checkoutId` string, required
  - `promotionId` string
  - `status` 'CONFIRMED' | 'PARTIALLY_IN_PRODUCTION' | 'IN_PRODUCTION' | 'PARTIALLY_SHIPPED' | 'SHIPPED' | 'PARTIALLY_DELIVERED' | 'DELIVERED' | 'CANCELLED' | 'COMPLETED', required
  - `email` string, required
  - `emailMarketingOptIn` boolean, required
  - `username` string
  - `message` string, required
  - `amounts` ComFourthwallOpenapiModelOrderV1OrderAmounts, required
    - `subtotal` Money, required
      - `value` number, required
      - `currency` string, required
    - `shipping` Money, required
      - `value` number, required
      - `currency` string, required
    - `tax` Money, required
      - `value` number, required
      - `currency` string, required
    - `donation` Money, required
      - `value` number, required
      - `currency` string, required
    - `discount` Money, required
      - `value` number, required
      - `currency` string, required
    - `giftCards` ComFourthwallOpenapiModelOrderV1GiftCard[], required
      - `code` string, required
      - `amountUsed` Money, required
        - `value` number, required
        - `currency` string, required
    - `total` Money, required
      - `value` number, required
      - `currency` string, required
  - `billing` ComFourthwallOpenapiModelOrderV1Billing
    - `address` ComFourthwallOpenapiModelAddress, required
      - `name` string, required
      - `address1` string, required
      - `address2` string
      - `city` string, required
      - `state` string, required
      - `country` string, required
      - `zip` string
      - `phone` string
  - `shipping` ComFourthwallOpenapiModelOrderV1Shipping
    - `address` ComFourthwallOpenapiModelAddress, required
      - `name` string, required
      - `address1` string, required
      - `address2` string
      - `city` string, required
      - `state` string, required
      - `country` string, required
      - `zip` string
      - `phone` string
  - `offers` ComFourthwallOpenapiModelOfferAbstractV1OfferOrderV1[], required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `description` string, required
    - `primaryImage` ComFourthwallOpenapiModelImage
      - `id` string, required
      - `url` string, required
      - `width` integer, required — The original width of the image in pixels.
      - `height` integer, required — The original height of the image in pixels.
      - `transformedUrl` string, required — Transformed URL with applied image processing (e.g., resizing, optimization)
    - `variant` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1OfferVariantWithQuantityV1, required
      - `id` string, required
      - `name` string, required
      - `sku` string, required
      - `unitPrice` Money, required
        - `value` number, required
        - `currency` string, required
      - `unitCost` Money
        - `value` number, required
        - `currency` string, required
      - `compareAtPrice` Money
        - `value` number, required
        - `currency` string, required
      - `attributes` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Attributes, required
        - `description` string, required
        - `color` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesColor
          - `name` string, required
          - `swatch` string, required
        - `size` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1AttributesSize
          - `name` string, required
      - `quantity` integer, required
      - `price` Money, required
        - `value` number, required
        - `currency` string, required
      - `cost` Money
        - `value` number, required
        - `currency` string, required
      - `weight` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Weight, required
        - `value` number, required
        - `unit` string, required
      - `dimensions` ComFourthwallOpenapiModelOfferAbstractV1OfferVariantAbstractV1Dimensions, required
        - `length` number, required
        - `width` number, required
        - `height` number, required
        - `unit` string, required
  - `source` union, required
    - ComFourthwallOpenapiModelOrderV1SourceGiveawayLinks
      - `type` 'GIVEAWAY_LINKS', required
      - `giftId` string, required
    - ComFourthwallOpenapiModelOrderV1SourceOrder
      - `type` 'ORDER', required
    - ComFourthwallOpenapiModelOrderV1SourceSamplesOrder
      - `type` 'SAMPLES_ORDER', required
    - ComFourthwallOpenapiModelOrderV1SourceTwitchGiftRedemption
      - `type` 'TWITCH_GIFT_REDEMPTION', required
      - `giftPurchaseId` string, required
      - `giftId` string, required
  - `trackingParams` ComFourthwallOpenapiModelOrderV1TrackingParams
    - `fbc` string
    - `fbp` string
    - `utm_source` string
    - `utm_medium` string
    - `utm_campaign` string
    - `utm_content` string
    - `utm_term` string
  - `metadata` object — Custom metadata passed during cart creation. Null for orders without metadata.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Possible errors: `WEBHOOK_NOT_SUPPORTED_ORDER_STATUS`, `WEBHOOK_NOT_SUPPORTED_ORDER_TYPE`
- `404` — Possible errors: `APPROVAL_SHEET_NOT_FOUND`, `CHECKOUT_NOT_FOUND_ERROR`, `OFFER_VARIANT_NOT_FOUND_ERROR`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)