---
title: "Query metrics"
method: GET
path: "/v1/metrics"
tags: ["Metrics"]
---

# Query metrics

`GET /v1/metrics`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/metrics`
- Auth: API key in header `X-API-Key`

Returns counts (sent, received, bounced) and resource totals (inboxes, domains) for a time window. Workspace master keys are locked to their own workspace; tenant master keys can scope with query params.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `workspace` string, uuid
- `inbox` string, uuid

## Response `200`

OK

- MetricsResponse
  - `window` object
    - `from` string, date-time
    - `to` string, date-time
  - `scope` object
    - `tenantId` string, uuid
    - `workspaceId` string, uuid, nullable
    - `inboxId` string, uuid, nullable
  - `counts` object
    - `sent` integer
    - `received` integer
    - `bounced` integer
  - `resources` object
    - `inboxes` integer
    - `domains` integer

---

[API](https://skmtc.dev/anjal/apis/anjal-api.md) · [All operations](https://skmtc.dev/anjal/apis/anjal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anjal/apis/anjal-api/revisions/a4044778e294?raw)