---
title: "Get Usage Metrics"
method: GET
path: "/billing/usage/metrics"
tags: ["Usage"]
---

# Get Usage Metrics

`GET /billing/usage/metrics`

Fetch detailed usage metrics for the organisation.

## Query parameters

- `page_size` integer, nullable
- `page` integer, nullable
- `sort` 'asc' | 'desc'
- `id` string, nullable
- `connector` string, nullable — Source connector name. Example: postgresql, mysql, ...
- `partial_name` string, nullable — Enter the source name you want to search for
- `tenant_ids` string, nullable — A comma-separated list of Tenant IDs
- `entity_type` string, nullable

## Request body

- GetUsageMetricsReqBody — Body model for POST /billing/usage/metrics requests. Supports large lists of IDs that would exceed URL length limits when using GET. Body parameters take precedence over query parameters when both are provided.
  - `tenant_ids` union — List of tenant IDs (as array) or comma-separated string. Body takes precedence over query params.
    - string[]
    - string

## Response `200`

Successful Response

- object

## 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/revisions/e9ce8221bac6/schema)