# List orders

**GET** `/orders`

Base URL: `https://sandbox.api.example.com/v1`

List orders

## Authorization

- bearerAuth (http, bearer)

## Query parameters

- `limit` (integer)
  Maximum number of orders to return.
- `status` (string)
  Only return orders with this status.

## Responses

### 200

A page of orders.

- `data` (object[])
  - `id` (string)
  - `amount` (integer)
  - `currency` (string)
  - `status` ("pending" | "paid" | "canceled")

Example:

```json
{
  "data": [
    {
      "id": "ord_123",
      "amount": 2500,
      "currency": "USD",
      "status": "pending"
    }
  ]
}
```

### 401

Missing or invalid API key.

- `error` (object)
  - `code` (string)
  - `message` (string)

Example:

```json
{
  "error": {
    "code": "not_found",
    "message": "Order not found."
  }
}
```