Skip to main content

Overview

After a checkout completes (hosted or headless), Henry creates an order and orchestrates fulfillment across one or more merchants. Use orders.list to fetch, filter, and monitor those orders from your backend.

Prerequisites


List orders

orders.list returns all orders for your application, newest first. It supports filtering and cursor-based pagination.

Filter by status

Filter by cart

Look up the order(s) tied to a specific cart:

Paginate through results


Track order updates

Orders move through states asynchronously. You have two options:
  • Poll for status - query orders.list (filtered by cartId) on an interval until the order reaches a terminal state.
  • Receive a webhook - use settings.events on cart.create to fire a webhook when the order completes, avoiding polling entirely. See Universal Cart - Cart events.

Order statuses explained


Filter reference


Error handling


Next steps

Checkout

Review both hosted and headless checkout flows

Universal Cart

Understand cart creation and item management