> ## Documentation Index
> Fetch the complete documentation index at: https://docs-restapi.wplimit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Orders

> Retrieve a list of orders with pagination and filtering options.

## Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number for pagination
</ParamField>

<ParamField query="per_page" type="integer" default="10">
  Number of orders per page (max 100)
</ParamField>

<ParamField query="customer_id" type="integer">
  Filter orders by customer ID
</ParamField>

<ParamField query="status" type="string">
  Filter orders by status. Valid values: `open`, `cancelled`, `completed`
</ParamField>

<ParamField query="payment_status" type="string">
  Filter orders by payment status. Valid values: `not_paid`, `partially_paid`, `fully_paid`, `processing`, `refunded`, `partially_refunded`
</ParamField>

<ParamField query="fulfillment_status" type="string">
  Filter orders by fulfillment status. Valid values: `not_fulfilled`, `partially_fulfilled`, `fulfilled`
</ParamField>

<ParamField query="coupon_code" type="string">
  Filter orders that used a specific coupon code (exact match)
</ParamField>

<ParamField query="total_min" type="number">
  Filter orders with a total amount greater than or equal to this value
</ParamField>

<ParamField query="total_max" type="number">
  Filter orders with a total amount less than or equal to this value
</ParamField>

<ParamField query="created_after" type="string">
  Filter orders created on or after this date (YYYY-MM-DD)
</ParamField>

<ParamField query="created_before" type="string">
  Filter orders created on or before this date (YYYY-MM-DD)
</ParamField>

<ParamField query="search" type="string">
  Search across confirmation code, customer comment, and coupon code
</ParamField>

<ParamField query="sort" type="string" default="created_at">
  Field to sort results by. Valid values: `id`, `total`, `created_at`, `status`
</ParamField>

<ParamField query="order" type="string" default="DESC">
  Sort direction. Valid values: `ASC`, `DESC`
</ParamField>

## Example Requests

### Basic pagination

```bash theme={null}
GET /wp-json/latepoint-api/v1/orders?page=1&per_page=5
Authorization: Bearer YOUR_API_KEY
```

### Filter by customer

```bash theme={null}
GET /wp-json/latepoint-api/v1/orders?customer_id=8
Authorization: Bearer YOUR_API_KEY
```

### Filter by status

```bash theme={null}
GET /wp-json/latepoint-api/v1/orders?status=open
Authorization: Bearer YOUR_API_KEY
```

### Filter by payment status

```bash theme={null}
GET /wp-json/latepoint-api/v1/orders?payment_status=not_paid
Authorization: Bearer YOUR_API_KEY
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "74",
      "confirmation_code": "277E2MW",
      "subtotal": "23.0000",
      "total": "23.0000",
      "status": "open",
      "fulfillment_status": "not_fulfilled",
      "payment_status": "not_paid",
      "customer_id": "30",
      "customer_comment": null,
      "coupon_code": "",
      "coupon_discount": "0.0000",
      "tax_total": "0.0000",
      "ip_address": null,
      "source_id": null,
      "source_url": "https://your-site.com/booking",
      "created_at": "2026-01-27 22:23:23",
      "updated_at": "2026-01-27 22:23:23"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "total": 51,
    "total_pages": 11,
    "has_next_page": true,
    "has_previous_page": false
  }
}
```

## Related Endpoints

Once you have an order ID from the list, you can access related resources:

### Order Invoices

```bash theme={null}
# Get all invoices for an order
GET /wp-json/latepoint-api/v1/orders/{order_id}/invoices

# Get a specific invoice
GET /wp-json/latepoint-api/v1/orders/{order_id}/invoices/{invoice_id}

# Update an invoice
PUT /wp-json/latepoint-api/v1/orders/{order_id}/invoices/{invoice_id}
```

### Order Transactions

```bash theme={null}
# Get all transactions for an order
GET /wp-json/latepoint-api/v1/orders/{order_id}/transactions

# Get a specific transaction
GET /wp-json/latepoint-api/v1/orders/{order_id}/transactions/{transaction_id}
```

### Example Usage

```bash theme={null}
# Get invoices for order 56
GET /wp-json/latepoint-api/v1/orders/56/invoices
Authorization: Bearer YOUR_API_KEY

# Get transactions for order 56
GET /wp-json/latepoint-api/v1/orders/56/transactions
Authorization: Bearer YOUR_API_KEY
```