# Spree Commerce documentation: v5.x API Reference Admin API Endpoints Orders > Spree Commerce is an open-source headless commerce platform. The backend runs as a Docker image (ghcr.io/spree/spree) and exposes REST Store and Admin APIs with OpenAPI specs, TypeScript SDKs (@spree/sdk, @spree/admin-sdk), webhooks and an MCP server with read and write tools, plus a React admin dashboard, a Next.js storefront, B2B and wholesale (companies, customer-specific catalogs and price lists) and a built-in multi-vendor marketplace. Start with `npx create-spree-app@latest my-store`: you need only Node.js, Git and Docker. ## Orders - [List claims](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-claims.md): Every damage or missing-item claim in the store, across all orders. - [List order claims](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-claims.md): The damage or missing-item claims opened on one order. - [Create a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-a-claim.md): Opens a damage or missing-item claim on a completed order. Each item says how it should be made right: money back, a replacement, or both. - [Update a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-a-claim.md): Edits the reason, memo or metadata of a claim. Its status moves only through the approve, resolve, deny and cancel actions. - [Approve a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/approve-a-claim.md): Accepts an open claim, the step before resolving it with a refund, a replacement or both. Only an open claim can be approved; deny it to turn it down. - [Resolve a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/resolve-a-claim.md): Settles an approved claim with money back, a replacement shipment, or both. - [Deny a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/deny-a-claim.md): Turns down an open claim, recording why for the customer. - [Cancel a claim](https://spreecommerce.org/docs/api-reference/admin-api/orders/cancel-a-claim.md): Withdraws a claim that has not been resolved. - [List order custom fields](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-custom-fields.md): Returns the order's custom field values. - [List digital links](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-digital-links.md): Returns the download links issued for digital products bought in this store, newest first. - [Get a digital link](https://spreecommerce.org/docs/api-reference/admin-api/orders/get-a-digital-link.md): Returns a single download link with its download count and expiry. - [Reset a digital link](https://spreecommerce.org/docs/api-reference/admin-api/orders/reset-a-digital-link.md): Gives the customer their full download allowance back and restarts the link's expiry clock. Use it when a download failed, or the file was replaced after the customer had used up their attempts. - [List exchanges](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-exchanges.md): Every exchange in the store, across all orders. - [List order exchanges](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-exchanges.md): The exchanges opened on one order. - [Create an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-an-exchange.md): Opens an exchange on a completed order: items coming back, and the variant that goes out in place of each. - [Update an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-an-exchange.md): Edits the warehouse, reason, memo or metadata of an exchange. Its status moves only through the approve, receive, fulfill and cancel actions. - [Approve an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/approve-an-exchange.md): Accepts a requested exchange so the customer can send the goods back for their replacement. Only a requested exchange can be approved; receive it once the goods arrive. - [Receive an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/receive-an-exchange.md): Records the goods that came back on an approved exchange. Omit `items` to receive everything as requested and resellable. - [Fulfill an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/fulfill-an-exchange.md): Ships the replacements for a received exchange and settles any price difference. - [Cancel an exchange](https://spreecommerce.org/docs/api-reference/admin-api/orders/cancel-an-exchange.md): Withdraws an exchange whose goods have not been received. - [List tax lines](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-tax-lines.md): Typed tax rows on the order. Read-only — written exclusively by the tax provider. - [List discounts](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-discounts.md): Typed discount rows (promotion-sourced and manual) on the order. - [Create manual discount](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-manual-discount.md): Creates a manual discount. With line_item_id a single row is created; without it the amount is distributed across line items (largest remainder). This is the sanctioned post-placement discount path and works on completed orders. - [Update manual discount](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-manual-discount.md): Edits the label or amount of a manual discount and re-sums the order totals. Promotion-sourced rows are owned by recalculation and respond 422. - [List fees](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-fees.md): Returns the order's fees, such as surcharges, handling and gift wrap, on the whole order or on one item or delivery. - [Create fee](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-fee.md): Creates a fee (surcharge, handling, gift wrap, COD, payment fee). Order-level when no target is given. Works on completed orders. - [Update fee](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-fee.md): Edits the label, amount or kind of a fee and re-sums the order totals. Works on completed orders. - [List order groups](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-groups.md): Returns checkouts split into one order per seller, grouping the orders placed together. - [Apply a discount code](https://spreecommerce.org/docs/api-reference/admin-api/orders/apply-a-discount-code.md): Applies a discount code to a draft order and returns the order. A real code the order does not yet qualify for is kept and applies once it does. Completed orders refuse codes; change their discounts through manual discounts instead. - [Apply a gift card to an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/apply-a-gift-card-to-an-order.md): Applies a gift card by code to the order. Returns the gift card. - [Remove a gift card from an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/remove-a-gift-card-from-an-order.md): Removes the gift card from the order. - [List order items](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-items.md): Returns all line items for an order. - [Add an item](https://spreecommerce.org/docs/api-reference/admin-api/orders/add-an-item.md): Adds a new line item to the order. - [Show an item](https://spreecommerce.org/docs/api-reference/admin-api/orders/show-an-item.md): Returns details of a specific line item. - [Remove an item](https://spreecommerce.org/docs/api-reference/admin-api/orders/remove-an-item.md): Removes an item from the order. - [Update an item](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-an-item.md): Updates an order item quantity or metadata. - [Apply customer's store credit to an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/apply-customers-store-credit-to-an-order.md): Applies the order customer's available store credit. When `amount` is omitted, applies up to the order outstanding balance. - [Remove store credit from an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/remove-store-credit-from-an-order.md): Removes any applied store credit from the order. - [List orders](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-orders.md): Returns a paginated list of orders for the current store. - [Create a draft order](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-a-draft-order.md): Creates a new draft order in one shot. Customer, items, addresses, currency, market, channel, locale, notes, metadata, and a coupon code can all be provided inline. - [Show an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/show-an-order.md): Returns full order details including admin-only fields. - [Delete a draft order](https://spreecommerce.org/docs/api-reference/admin-api/orders/delete-a-draft-order.md): Deletes a draft order. Completed orders cannot be deleted. - [Update an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-an-order.md): Updates an order. Supports updating email, addresses, special instructions, and line items. - [Complete an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/complete-an-order.md): Completes an order in the `confirm` state, marking it as placed. - [Cancel an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/cancel-an-order.md): Cancels a completed order. - [Approve an order](https://spreecommerce.org/docs/api-reference/admin-api/orders/approve-an-order.md): Approves an order (e.g., for fraud review). - [Resend confirmation email](https://spreecommerce.org/docs/api-reference/admin-api/orders/resend-confirmation-email.md): Publishes the order.completed event to trigger confirmation email delivery. - [Resend digital download links](https://spreecommerce.org/docs/api-reference/admin-api/orders/resend-digital-download-links.md): Emails the customer their download links for the digital products on this order again. Nothing is sent when the order has no digital links or the store does not send transactional emails. Use it when the original email was lost; to restore used-up downloads or an expired link, reset the digital link… - [List returns](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-returns.md): Every return in the store, across all orders. - [List order returns](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-order-returns.md): The returns opened on one order. - [Create a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/create-a-return.md): Opens a return on a completed order for fulfilled units the customer is sending back. - [Update a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/update-a-return.md): Edits the warehouse, reason, memo or metadata of a return. Its status moves only through the approve, receive, refund and cancel actions. - [Approve a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/approve-a-return.md): Accepts a requested return so the customer can send the goods back. Only a requested return can be approved; receive it once the goods arrive. - [Receive a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/receive-a-return.md): Records what arrived on an approved return. Omit `items` to receive everything as requested and resellable; send rows for a partial or damaged receipt. - [Refund a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/refund-a-return.md): Pays the customer back for a received return, to store credit or through the original payment. - [Cancel a return](https://spreecommerce.org/docs/api-reference/admin-api/orders/cancel-a-return.md): Withdraws a return whose goods have not been received. - [List return labels](https://spreecommerce.org/docs/api-reference/admin-api/orders/list-return-labels.md): The shipping labels issued for sending one return back to the store. - [Refund a return label](https://spreecommerce.org/docs/api-reference/admin-api/orders/refund-a-return-label.md): Asks the carrier to refund a purchased return label the customer never used, such as when the return is canceled. An uploaded label has nothing to refund. ## OpenAPI Specs - [admin](/docs/api-reference/admin.yaml)