---
title: "Get topic metrics"
method: GET
path: "/topics/metrics"
tags: ["Topics"]
---

# Get topic metrics

`GET /topics/metrics`

## Query parameters

- `timestamp_to` string, nullable
- `timestamp_from` string, nullable
- `time_type` string, nullable
- `time_interval` integer, nullable
- `time_unit` string, nullable
- `entity_type` string, nullable — Filter by entity type. Valid values: sources, transforms. Comma-separated for multiple (e.g., 'sources,transforms').
- `entity_id` string, nullable — Filter by specific entity IDs (comma-separated list).
- `value_format` string, nullable — Filter by serialization value format. Valid values: avro, json, json_schema, protobuf, string, bytearray. Case-insensitive.
- `has_errors` boolean, nullable — Filter topics by error status. true = only topics with recordErrorTotal > 0.
- `partial_name` string, nullable — Filter by topic name (partial match).

## Response `200`

Successful Response

- TopicMetricsRes
  - `timeseries` TopicTimeseriesMetrics
    - `byteTotal` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `SnapshotTotalNumberOfEventsSeen` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `StreamingTotalNumberOfCreateEventsSeen` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `StreamingTotalNumberOfDeleteEventsSeen` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `StreamingTotalNumberOfUpdateEventsSeen` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `recordRetryTotal` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
    - `recordSendTotal` TimeseriesEntry[]
      - `value` union, required — The metric value at this timestamp
        - integer
        - number
      - `timestamp` string, required — ISO 8601 timestamp for this data point
  - `latest` TopicLatestMetrics
    - `byteTotal` union
      - integer
      - number
    - `SnapshotTotalNumberOfEventsSeen` union
      - integer
      - number
    - `StreamingTotalNumberOfCreateEventsSeen` union
      - integer
      - number
    - `StreamingTotalNumberOfDeleteEventsSeen` union
      - integer
      - number
    - `StreamingTotalNumberOfUpdateEventsSeen` union
      - integer
      - number
    - `recordRetryTotal` union
      - integer
      - number
    - `recordSendTotal` union
      - integer
      - number

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)