Get order with full details

GET /v1/orders/{orderId}

Get order with full details

Requires: order.view

Path Parameters

orderId required

string

The order's unique identifier

Response Schema

OrderDetailsResponse

customerrequirednullable

object

Customer entity representing a retail customer

countryCodeoptionalnullable

string

createdAtrequired

string

format: date-time

customMetadataoptional

Record<string, any>

Construct a type with a set of properties K of type T

emailoptionalnullable

string

externalIdoptionalnullable

string

idrequired

string

pattern: ^[a-z0-9]{24}$

nameoptionalnullable

string

phoneoptionalnullable

string

provinceCodeoptionalnullable

string

sourceoptionalnullable

enum

etsyshopifymanualebaytiktok-shopwoocommerceshipstationwix

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

updatedAtrequired

string

format: date-time

zipCodeoptionalnullable

string

itemsrequired

object[]

createdAtrequired

string

format: date-time

customMetadataoptional

Record<string, any>

Construct a type with a set of properties K of type T

externalIdoptionalnullable

string

externalOrderIdoptionalnullable

string

externalProductIdoptionalnullable

string

externalSkuoptionalnullable

string

idrequired

string

pattern: ^[a-z0-9]{24}$

ignoredoptionalnullable

boolean

inputsoptionalnullable

Record<string, any>

Construct a type with a set of properties K of type T

orderIdrequired

string

pattern: ^[a-z0-9]{24}$

originalSkuoptionalnullable

string

Original SKU identifier sent when creating the order item (sku or externalSku), null if skuId was provided directly

processedAtoptionalnullable

string

format: date-time

processedStatusoptionalnullable

"unprocessed" | "processed"

unprocessedprocessed

quantityrequired

number

min: 1

resolutionNoteoptionalnullable

object

Structured note describing why SKU or variant resolution failed. Stored as a dedicated column on order_items for easy querying.

messagerequired

string

occurredAtrequired

number

Timestamp of when this failure occurred

retriablerequired

boolean

Whether this failure can be retried (e.g., API errors are retriable, missing SKUs are not)

typerequired

"variant_enrichment_failed" | "sku_not_found" | "ambiguous_match"

variant_enrichment_failedsku_not_foundambiguous_match

skuConfigoptionalnullable

object

SKU configuration stored with order items Contains only the configuration overrides, not the SKU reference

freeTextOptionIdsoptional

string[]

Options whose selected value is a buyer's free-text answer rather than one of the option's defined values. A personalization question can reuse a variant option (same name), and its arbitrary answers must not be flagged as invalid values during reconciliation.

linkedPartConfigsoptional

Record<string, object>

Construct a type with a set of properties K of type T

personalizationAnswerKeysoptional

string[]

selectedOptions keys the integration wrote from buyer personalization answers (as opposed to regular variation selections). Only these may be treated as free text when they land on a variant option; an unmatched regular variation value must still fail validation.

selectedOptionsoptional

Record<string, string>

Construct a type with a set of properties K of type T

skuIdrequirednullable

string

pattern: ^[a-z0-9]{24}$

sourceoptionalnullable

enum

etsyshopifymanualebaytiktok-shopwoocommerceshipstationwix

statusoptionalnullable

string

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

updatedAtrequired

string

format: date-time

orderrequired

object

Order entity representing a retail order

cancelledAtoptionalnullable

string

createdAtrequired

string

format: date-time

currencyoptionalnullable

string

customerIdoptionalnullable

string

pattern: ^[a-z0-9]{24}$

customMetadataoptional

Record<string, any>

Construct a type with a set of properties K of type T

deadlineoptionalnullable

string

externalIdoptionalnullable

string

externalUrloptionalnullable

string

idrequired

string

pattern: ^[a-z0-9]{24}$

integrationIdoptionalnullable

string

pattern: ^[a-z0-9]{24}$

noteoptionalnullable

string

orderNumberrequired

string

priceoptionalnullable

number

priceBucketoptionalnullable

number

processedAtoptionalnullable

string

shippedAtoptionalnullable

string

sourceoptionalnullable

enum

etsyshopifymanualebaytiktok-shopwoocommerceshipstationwix

sourceRefoptionalnullable

string

statusrequired

"open" | "closed"

openclosed

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

syncDisabledrequired

boolean

updatedAtrequired

string

format: date-time

Example Response

200 OK — application/json

{
  "order": {
    "orderNumber": "string",
    "source": "etsy",
    "status": "open",
    "cancelledAt": "2025-01-15T12:00:00.000Z",
    "shippedAt": "2025-01-15T12:00:00.000Z",
    "customerId": "string",
    "integrationId": "string",
    "priceBucket": 1,
    "price": 1,
    "currency": "string",
    "externalId": "string",
    "externalUrl": "string",
    "sourceRef": "string",
    "note": "string",
    "deadline": "2025-01-15T12:00:00.000Z",
    "processedAt": "2025-01-15T12:00:00.000Z",
    "syncDisabled": true,
    "customMetadata": {},
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  },
  "customer": {
    "name": "string",
    "email": "string",
    "phone": "string",
    "countryCode": "string",
    "provinceCode": "string",
    "zipCode": "string",
    "externalId": "string",
    "source": "etsy",
    "customMetadata": {},
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  },
  "items": [
    {
      "orderId": "string",
      "skuId": "string",
      "source": "etsy",
      "quantity": 1,
      "inputs": {},
      "status": "string",
      "externalId": "string",
      "externalOrderId": "string",
      "externalProductId": "string",
      "externalSku": "string",
      "originalSku": "string",
      "processedAt": "2025-01-15T12:00:00.000Z",
      "ignored": true,
      "processedStatus": "unprocessed",
      "skuConfig": {
        "linkedPartConfigs": {},
        "selectedOptions": {},
        "freeTextOptionIds": [
          "string"
        ],
        "personalizationAnswerKeys": [
          "string"
        ]
      },
      "resolutionNote": {
        "type": "variant_enrichment_failed",
        "message": "string",
        "retriable": true,
        "occurredAt": 1
      },
      "customMetadata": {},
      "id": "string",
      "storeId": "string",
      "createdAt": "2025-01-15T12:00:00.000Z",
      "updatedAt": "2025-01-15T12:00:00.000Z"
    }
  ]
}