---
title: "Get tenant usage information"
method: GET
path: "/usage"
---

# Get tenant usage information

`GET /usage`

Retrieves comprehensive usage statistics for the current tenant including total object counts and a per-schema breakdown for billing and analytics.

## Response `200`

Tenant usage data retrieved successfully

- TenantUsageResponse — Comprehensive usage statistics for a tenant.
  - `totalObjectsCount` integer, required — Total number of objects across all schemas in the tenant.
  - `perSchemaUsageInfo` SchemaUsageInfo[], required — Per-schema breakdown of usage information.
    - `schemaId` integer, required — The unique identifier of the schema.
    - `schemaName` string, required — The display name of the schema.
    - `schemaCreatedAt` string, date-time, required — The timestamp when the schema was created (ISO 8601).
    - `objectCount` integer, required — The number of objects in this schema.

## Other responses

- `401` — Client must be authenticated to access this resource.
- `403` — Authenticated user is missing permission to fulfill the request
- `500` — Something went wrong. Please try again later. If the error persists, contact our support team.

---

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