---
title: "Get workspace usage"
method: GET
path: "/v1/workspace/usage"
tags: ["Workspace Usage"]
---

# Get workspace usage

`GET /v1/workspace/usage`

Returns API credit consumption for the current billing period for the workspace resolved from the API key.

## Response `200`

- WorkspaceUsageDto
  - `credits_used` number, required — API credits consumed in the current billing period
  - `credits_limit` number, required — API credit limit for the current billing period
  - `credits_remaining` number, required — Credits left before requests are rate limited
  - `reset_date` string, required — When the credit counter resets — start of the next billing period (UTC, ISO 8601)
  - `by_family` UsageByFamilyDto[], required — Credits and request counts grouped by operation family
    - `family` string, required
    - `credits` number, required
    - `requests` number, required
  - `by_route` UsageByRouteDto[], required — Credits and request counts grouped by exact route
    - `method` string, required
    - `route` string, required
    - `credits` number, required
    - `requests` number, required

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)