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

> List all metrics.

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

## Returns

Returns a list of [Metric](https://docs.galtea.ai/v5.10/concepts/metric.md) objects.

## Example

```python theme={"system"}
metrics = galtea.metrics.list(limit=20)
```

## Parameters

**from\_created\_at** `str | int` (default: None)

Filter metrics created at or after this timestamp. Accepts ISO 8601 string (e.g., `'2024-01-01T00:00:00Z'`) or Unix timestamp in seconds. Can be used independently or together with `to_created_at`.

**to\_created\_at** `str | int` (default: None)

Filter metrics created at or before this timestamp. Accepts ISO 8601 string (e.g., `'2024-12-31T23:59:59Z'`) or Unix timestamp in seconds. Can be used independently or together with `from_created_at`.

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

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

**offset** `int` (default: 0)

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

**Default:** `0` (start from the beginning)

**limit** `int` (default: 10000)

Maximum number of metrics to return in a single request.

**Default:** `10000`

**include\_legacy** `bool` (default: False)

Whether to include deprecated (legacy) metrics in the results.

**Default:** `False` — deprecated metrics are excluded. Set to `True` to also retrieve metrics that have been deprecated.

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

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

**tags** `list[string]`

Filter metrics by tags. Returns metrics that have at least one of the provided tags (match-any semantics).

**include\_excluded\_from\_analytics** `bool` (default: False)

Keyword-only. Whether to include metric revisions [excluded from analytics](https://docs.galtea.ai/v5.10/concepts/metric.md#revisions-and-analytics) in the results.

**Default:** `False` — excluded revisions are hidden. Set to `True` to also retrieve them. A lookup by `id` always returns the metric, excluded or not.


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