---
title: "Get function metric aggregates"
method: GET
path: "/compute/funcs/{id}/metric_aggregates"
tags: ["functions"]
---

# Get function metric aggregates

`GET /compute/funcs/{id}/metric_aggregates`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/compute/funcs/{id}/metric_aggregates`
- Auth: HTTP bearer

Returns aggregate request, latency, CPU, memory, and resource-limit metrics for a function over the requested window.

## Path parameters

- `id` string, required

## Query parameters

- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `filter[edge_site]` string
- `filter[namespace]` string
- `page[number]` integer
- `page[size]` integer

## Response `200`

Metric aggregates retrieved successfully

- FunctionMetricAggregateListResponse
  - `meta` FunctionsObservabilityPaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer
  - `data` FunctionMetricAggregate[]
    - `record_type` string
    - `product` string
    - `start_time` string, date-time
    - `end_time` string, date-time
    - `function_id` string
    - `function_name` string
    - `request_count` number, nullable
    - `request_success_rate` number, nullable
    - `request_client_error_rate` number, nullable
    - `request_error_rate` number, nullable
    - `request_latency_p50_ms` number, nullable
    - `request_latency_p95_ms` number, nullable
    - `request_latency_p99_ms` number, nullable
    - `request_latency_avg_ms` number, nullable
    - `cpu_used_cores_avg` number, nullable
    - `cpu_used_cores_max` number, nullable
    - `memory_used_bytes_avg` number, nullable
    - `memory_used_bytes_max` number, nullable

## Other responses

- `401`: Unauthorized
- `404`: Function not found
- `422`: Invalid function ID or query parameter
- `500`: Internal server error
- `502`: Metrics backend query failed
- `503`: Metrics backend unavailable
- `504`: Metrics backend timed out

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/compute/funcs/:id/metric_aggregates/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)