E-Commerce Requires WooCommerce

Headless Orders

REST API endpoint for authenticated customers to list their own WooCommerce orders. Supports pagination, status filtering, and returns billing/shipping addresses with line items. Pairs with the WooCommerce Store API single-order endpoint for a complete order-browsing experience.

View Source

Features

JWT Bearer-token authentication with proper 401 responses

Pagination with per_page and page query parameters

Filter by order status (pending, processing, completed, etc.)

Full billing and shipping address details

Line items with product ID, name, quantity, and totals

X-WP-Total and X-WP-TotalPages response headers

API Endpoints

Method	Path	Description
GET	/headless-orders/v1/orders	List customer orders with pagination and status filtering

FAQ

How does authentication work?

The plugin relies on JWT authentication provided by a companion plugin (e.g., Headless Auth). The JWT token must be sent as a Bearer token in the Authorization header. The plugin itself does not issue tokens.

Can a customer see other customers' orders?

No. The endpoint strictly filters by the authenticated user's ID. There is no way for one customer to access another's orders.