---
title: "List Usage Requests"
method: GET
path: "/usage/requests"
tags: ["usage"]
---

# List Usage Requests

`GET /usage/requests`

## Request

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

List the deck-generation requests this key made, newest first.

## Query parameters

- `since` string, date-time, nullable
- `until` string, date-time, nullable
- `status` 'CREATED' | 'RUNNING' | 'COMPLETED' | 'FAILED': Lifecycle state of an async task.
- `page` integer
- `limit` integer

## Response `200`

Successful Response

- PageAPIUsageRequest
  - `data` APIUsageRequest[], required
    - `task_id` string, uuid, required
    - `request_id` string, nullable, required
    - `api_key_id` string, uuid, nullable, required
    - `deck_id` string, uuid, required
    - `status` 'CREATED' | 'RUNNING' | 'COMPLETED' | 'FAILED', required: Lifecycle state of an async task.
    - `stage` 'QUEUED' | 'OUTLINE' | 'SLIDES' | 'EXPORT' | 'COMPLETED' | 'FAILED' | 'ENRICHING' | 'SCRAPING' | 'ANALYZING' | 'GENERATING_VISUALS' | 'SAVING', required: Durable, caller-visible deck-generation stage.
    - `created_at` string, date-time, required
    - `finished_at` string, date-time, nullable, required
    - `duration_seconds` number, nullable, required
    - `credits_consumed` integer, required
    - `error` string, nullable, required
  - `page` integer, required
  - `limit` integer, required
  - `total` 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)