> ## 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.

> [!WARNING]
>
> You are reading the docs of Galtea 5.13. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/monitor/list.md).

## Returns

Returns a list of [Monitor](https://docs.galtea.ai/v5.13/concepts/product/monitor.md) objects.

## Example

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

## Parameters

**product\_ids** `list[string]`

Filter monitors by product IDs.

**version\_ids** `list[string]`

Filter monitors by version IDs.

**names** `list[string]`

Filter by exact monitor names.

**name** `string`

Filter by partial name match.

**statuses** `list[string | MonitorStatus]`

Filter by monitor status.
Possible values: `ACTIVE`, `PAUSED`, `CAPPED`, `NO_CREDITS`, `FAILING`. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

**metric\_group\_ids** `list[string]`

Filter by metric family IDs (`metric.metric_group_id`). A monitor matches only when it picked the family
directly. A family it scores only through a bound Specification does not match.

**from\_created\_at** `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.

**to\_created\_at** `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.

**sort\_by\_created\_at** `string`

Sort monitors by creation date. Valid values are `"asc"` and `"desc"`.

**offset** `int`

Number of monitors to skip before starting to collect results. Use for pagination.

**limit** `int`

Maximum number of monitors to return in a single request.

**id** `string | list[string]` (default: None)

The ID or IDs of the monitor(s) to retrieve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.