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

# List Orders

> Returns a paginated list of orders for the authenticated user with optional filtering

## List Orders

`GET /api/v1/orders`

Returns a paginated list of orders for the authenticated user with optional filtering.

### Query Parameters

| Parameter            | Type    | Default | Description                                                                                           |
| -------------------- | ------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `per_page`           | integer | 15      | Number of items per page (max: 100)                                                                   |
| `fulfillment_status` | string  | —       | Filter by fulfillment status: `pending`, `processing`, `partially_fulfilled`, `completed`, `refunded` |
| `payment_status`     | string  | —       | Filter by payment status: `pending`, `completed`                                                      |

### Responses

| Status             | Description                             |
| ------------------ | --------------------------------------- |
| `200 OK`           | Successful operation                    |
| `401 Unauthorized` | Missing or invalid authentication token |
| `403 Forbidden`    | Access denied                           |

### Example Response

```json theme={null}
{
  "data": [
    {
      "id": 12345,
      "ulid": "01J9Z3NDEKTSV4RRFFQ69G5FAV",
      "order_number": "#ORD-12345",
      "fulfillment_status": "completed",
      "payment_status": "completed",
      "subtotal": { "amount": 99.99, "formatted": "€99.99" },
      "conversion_fees": { "amount": 2.5, "formatted": "€2.50" },
      "total": { "amount": 102.49, "formatted": "€102.49" },
      "currency": "EUR",
      "items": [],
      "created_at": "2023-01-01T12:00:00+00:00",
      "updated_at": "2023-01-01T12:00:00+00:00"
    }
  ],
  "links": {
    "first": "https://api.example.com/orders?page=1",
    "last": "https://api.example.com/orders?page=5",
    "prev": null,
    "next": "https://api.example.com/orders?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.example.com/orders",
    "per_page": 15,
    "to": 15,
    "total": 75
  }
}
```