# Order Index Endpoint

This endpoint retrieves a paginated list of all orders

#### Structure

See [`Order View Endpoint`](https://support.aerocommerce.com/books/api/page/order-view-endpoint) for the structure of the order payload inside the `data` array.

---

#### Scopes

<table border="1" id="bkmrk-name-description-exa" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Description**  
</td><td>**Example**  
</td></tr><tr><td>`visible`</td><td>Only return visible orders (those which have been ordered)</td><td>`?scope=visible`</td></tr><tr><td>`outstanding`</td><td>Only return outstanding orders</td><td>`?scope=outstanding`</td></tr><tr><td>`completed`</td><td>Only return completed orders</td><td>`?scope=completed`</td></tr><tr><td>`incomplete`</td><td>Only return incomplete orders</td><td>`?scope=incomplete`</td></tr><tr><td>`express`</td><td>Only return express orders</td><td>`?scope=express`</td></tr><tr><td>`standard`</td><td>Only return standard orders</td><td>`?scope=standard`</td></tr></tbody></table>

---

#### Filters

<table border="1" id="bkmrk-name-description-exa-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Description**  
</td><td>**Example**  
</td></tr><tr><td>`reference`</td><td>Only return orders with specific references</td><td>`?references=ABC123,DEF456`</td></tr><tr><td>`statuses`</td><td>Only return orders with specific status ids or names</td><td>`?statuses=1,On Hold`</td></tr><tr><td>`states`</td><td>Only return orders with specific states</td><td>`?states=dispatched,returned`</td></tr><tr><td>`customers`</td><td>Only return orders with specific customers (by id or email)</td><td>`?customers=1,test@gmail.com`</td></tr><tr><td>`emails`</td><td>Only return orders for specific emails</td><td>`?emails=test@gmail.com`</td></tr><tr><td>`channels`</td><td>Only return orders for specific channels</td><td>`?channels=web,api`</td></tr><tr><td>`flags`</td><td>Only return orders for specific flags (by `id`, `name`, or `name|value`)</td><td>`?flags=1,abc,def|123`</td></tr></tbody></table>

---

```
GET /api/orders?per_page=2&min_ordered_at=2023-08-30%2010:36:23
```

```json
{
    "current_page": 1,
    "data": [
      //...
    ],
    "first_page_url": "http://aero.test/api/orders?page=1",
    "from": 1,
    "last_page": 3,
    "last_page_url": "http://aero.test/api/orders?page=3",
    "next_page_url": "http://aero.test/api/orders?page=2",
    "path": "http://aero.test/api/orders",
    "per_page": 2,
    "prev_page_url": null,
    "to": 2,
    "total": 5
}
```

<p class="callout info">See [`Order View Endpoint`](https://support.aerocommerce.com/books/api/page/order-view-endpoint) for the structure of the order payload inside the `data` array.</p>