---
title: "Get AgentOS Metrics"
method: GET
path: "/metrics"
tags: ["Metrics"]
---

# Get AgentOS Metrics

`GET /metrics`

Retrieve AgentOS metrics and analytics data for a specified date range. If no date range is specified, returns all available metrics.

## Query parameters

- `starting_date` string, date, nullable — Starting date for metrics range (YYYY-MM-DD format)
- `ending_date` string, date, nullable — Ending date for metrics range (YYYY-MM-DD format)
- `db_id` string, nullable — Database ID to query metrics from
- `table` string, nullable — The database table to use

## Response `200`

Metrics retrieved successfully

- MetricsResponse
  - `metrics` DayAggregatedMetrics[], required — List of daily aggregated metrics
    - `id` string, required — Unique identifier for the metrics record
    - `agent_runs_count` integer, required — Total number of agent runs
    - `agent_sessions_count` integer, required — Total number of agent sessions
    - `team_runs_count` integer, required — Total number of team runs
    - `team_sessions_count` integer, required — Total number of team sessions
    - `workflow_runs_count` integer, required — Total number of workflow runs
    - `workflow_sessions_count` integer, required — Total number of workflow sessions
    - `users_count` integer, required — Total number of unique users
    - `token_metrics` object, required — Token usage metrics (input, output, cached, etc.)
    - `model_metrics` object[], required — Metrics grouped by model (model_id, provider, count)
    - `date` string, date-time, required — Date for which these metrics are aggregated
    - `created_at` string, date-time, required — Timestamp when metrics were created
    - `updated_at` string, date-time, required — Timestamp when metrics were last updated
  - `updated_at` string, date-time, nullable — Timestamp of the most recent metrics update

## Other responses

- `400` — Invalid date range parameters
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Failed to retrieve metrics

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)