---
title: "Get metrics records"
method: GET
path: "/unit-cost/v1/telemetry/metric/{metric_name}"
tags: ["telemetry"]
---

# Get metrics records

`GET /unit-cost/v1/telemetry/metric/{metric_name}`

Get most recently submitted telemetry records for a given stream.

**Note**: Recently submitted records can take several minutes to be available through this endpoint.

## Path parameters

- `metric_name` string, required

## Query parameters

- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Telemetry records

## Other responses

- `403` — Not authorized, make sure you're using a valid API key in the header `Authorization`
- `429` — Rate limit exceeded. The API enforces rate limiting on incoming requests. Retry after a short delay.
- `503` — Service temporarily unavailable due to downstream capacity constraints. Retry after a short delay with exponential backoff.

---

[API](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources.md) · [All operations](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudzero/cloudzero-api-v2-resources/revisions/fd805a0e75e5/schema)