Skip to main content

Get Faire Order

GET 
/api/faire/orders/:order

Get details of a specific Faire order including its line items.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Path Parameters:

  • order — The internal Faire order ID (faire_orders.id)

Response: Returns the full FaireOrderDetail (Faire order object on show) including raw_data, sales_order, is_archived, archived_at, faire_admin_url, and the line_items array. Each line item includes:

  • id, faire_line_item_id, faire_product_id, faire_variant_id — Faire-side identifiers
  • sku, name, option_values — Product details from Faire
  • quantity, unit_price, total_price
  • sku_product_id — The matched SKU.io products.id (null when the variant is unmapped)
  • sku_product_route — application UI route path to the matched product (null when unmapped)
  • sku_product — Mapped SKU.io product block { id, sku, name, type } for the "Linked Product" column on the order detail page (null when unmapped). Mirrors the Shopify line-item shape.

Linked product resolution: All three sku_product* fields are resolved via the explicit FaireProductOption → ProductListing → Product chain (joined on faire_variant_id), populated by the Variants Listing page "Map" button / Smart Match / Bulk Map. String-based SKU matching is NOT used. If a variant has never been mapped, the fields are null even when the line’s sku happens to match a Product’s sku — same behaviour as the Shopify order line resource.

Error Responses:

  • 404 Not Found — Order not found

Request​

Responses​

OK

Response Headers
    Content-Type