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

# Listing Monitors

> List monitors with optional filters.

## Returns

Returns a list of [Monitor](/concepts/product/monitor) objects.

## Example

```python theme={"system"}
monitors = galtea.monitors.list(
    product_ids=[product_id],
    statuses=["ACTIVE"],
)
```

## Parameters

<ResponseField name="product_ids" type="list[string]" optional>
  Filter monitors by product IDs.
</ResponseField>

<ResponseField name="version_ids" type="list[string]" optional>
  Filter monitors by version IDs.
</ResponseField>

<ResponseField name="names" type="list[string]" optional>
  Filter by exact monitor names.
</ResponseField>

<ResponseField name="name" type="string" optional>
  Filter by partial name match.
</ResponseField>

<ResponseField name="statuses" type="list[string | MonitorStatus]" optional>
  Filter by monitor status.
  Possible values: `ACTIVE`, `PAUSED`, `CAPPED`, `NO_CREDITS`, `FAILING`.
</ResponseField>

<ResponseField name="metric_group_ids" type="list[string]" optional>
  Filter by bound metric family IDs (`metric.metric_group_id`).
</ResponseField>

<ResponseField name="from_created_at" type="str | int" default="None">
  Filter monitors created at or after this timestamp. Accepts ISO 8601 string (e.g., `'2024-01-01T00:00:00Z'`) or Unix timestamp in seconds.
</ResponseField>

<ResponseField name="to_created_at" type="str | int" default="None">
  Filter monitors created at or before this timestamp. Accepts ISO 8601 string (e.g., `'2024-12-31T23:59:59Z'`) or Unix timestamp in seconds.
</ResponseField>

<ResponseField name="sort_by_created_at" type="string" optional>
  Sort monitors by creation date. Valid values are `"asc"` and `"desc"`.
</ResponseField>

<ResponseField name="offset" type="int" optional>
  Number of monitors to skip before starting to collect results. Use for pagination.
</ResponseField>

<ResponseField name="limit" type="int" optional>
  Maximum number of monitors to return in a single request.
</ResponseField>

<ResponseField name="id" type="string | list[string]" default="None">
  The ID or IDs of the monitor(s) to retrieve.
</ResponseField>