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

# List orders

> Retrieve a paginated list of orders for the authenticated user.

Returns the user's orders, sorted by creation date descending.

## Query parameters

<ParamField query="limit" type="integer" default="50">
  Number of results to return. Min `1`, max `100`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip for pagination.
</ParamField>

<ParamField query="status" type="string">
  Filter by order status. One of: `pending`, `pending_payment`, `active`, `failed`, `cancelled`, `expired`.
</ParamField>

## Response

<ResponseField name="orders" type="array">
  List of order objects. Same shape as [Create order response](/api/orders/create-order#response).
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of orders matching the filter.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.proxyjam.com/public/v1/orders?status=active&limit=10" \
    -H "X-API-Key: pj_AbCdEf..."
  ```

  ```python Python theme={null}
  from proxyjam import ProxyJamClient

  with ProxyJamClient(api_key="pj_live_...") as proxyjam:
      page = proxyjam.orders.list(limit=10, offset=0)
      for order in page.orders:
          print(order.id, order.status, order.country)
      print(f"total: {page.total}")
  ```

  ```json Response theme={null}
  {
    "orders": [
      {
        "id": "order-uuid-here",
        "status": "active",
        "total_usd": 7.0,
        "proxy_type": "residential",
        "country": "US",
        "quantity": 2,
        "period_days": 30,
        "created_at": "2024-01-15T10:00:00Z",
        "proxy_access": [ ... ]
      }
    ],
    "total": 1
  }
  ```
</CodeGroup>