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

# Get Usage

`GET /usage`

## Request

- Base URL: `https://api.presentations.ai/api/v1`
- URL: `https://api.presentations.ai/api/v1/usage`
- Auth: HTTP bearer

Return requests, success rate, durations and credits for this key.

## Query parameters

- `since` string, date-time, nullable
- `until` string, date-time, nullable

## Response `200`

Successful Response

- APIUsageSummary: Usage over a window, for one key or for every key in scope.
  - `workspace_id` string, uuid, required
  - `api_key_id` string, uuid, nullable, required
  - `since` string, date-time, nullable, required
  - `until` string, date-time, nullable, required
  - `requests` APIUsageRequestCounts, required: Deck-generation requests by lifecycle outcome.
    - `total` integer, required
    - `completed` integer, required
    - `failed` integer, required
    - `in_progress` integer, required
  - `success_rate` number, nullable, required
  - `avg_duration_seconds` number, nullable, required
  - `credits_consumed` integer, required
  - `by_feature` APIUsageFeature[], required
    - `feature` string, required
    - `credits` integer, required
    - `uses` integer, required
  - `by_key` APIUsageKey[], required
    - `api_key_id` string, uuid, required
    - `name` string, nullable, required
    - `prefix` string, nullable, required
    - `requests` integer, required
    - `credits_consumed` integer, required

## Other responses

- `401`: Missing, malformed, expired, or revoked Bearer API key.
- `403`: The API key, workspace role, project scope, or plan lacks permission.
- `422`: A path, query, header, or request-body field failed validation.
- `429`: The caller exceeded the API rate limit.
- `500`: Unexpected server failure. Retry only idempotent operations and retain trace_id.

---

[API](https://skmtc.dev/presentations/apis/presentation-services-api.md) · [All operations](https://skmtc.dev/presentations/apis/presentation-services-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presentations/apis/presentation-services-api/revisions/da06cb2e2f32?raw)