---
title: "Query Metrics"
method: GET
path: "/v0/pods/{pod_id}/metrics"
tags: ["PodsMetrics"]
---

# Query Metrics

`GET /v0/pods/{pod_id}/metrics`

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/pods/{pod_id}/metrics`
- Auth: HTTP bearer

**CLI:**
```bash
agentmail pods:metrics query --pod-id <pod_id>
```

## Path parameters

- `pod_id` string, required: ID of pod.

## Query parameters

- `event_types` MetricEventType[]: List of metric event types to query.
- `start` string, date-time: Start timestamp for the query.
- `end` string, date-time: End timestamp for the query.
- `period` string: Period in number of seconds for the query.
- `limit` integer: Limit on number of buckets to return.
- `descending` boolean: Sort in descending order.

## Response `200`

- QueryMetricsResponse: Metrics grouped by event type.

## Other responses

- `400`

---

[API](https://skmtc.dev/agentmail-to/apis/agentmail-cli-speakeasy-api.md) - [All operations](https://skmtc.dev/agentmail-to/apis/agentmail-cli-speakeasy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentmail-to/apis/agentmail-cli-speakeasy-api/revisions/869b7f1c360c?raw)