---
title: "Retrieve API usage"
method: GET
path: "/v1/usage"
tags: ["Usage"]
---

# Retrieve API usage

`GET /v1/usage`

Retrieve API usage statistics for your workspace. Note that the statistics returned are for content generation requests only (e.g Run command or Run template).

## Query parameters

- `start` string, required
- `end` string, required
- `granularity` 'week' | 'day' | 'hour', required

## Response `200`

Retrieved API usage.

- UsageResponseDto
  - `requestId` string
  - `resource` string
  - `data` UsageRequest
    - `requests` Usage[]
      - `t` string
      - `v` number

## Other responses

- `400` — Bad request. May be missing required inputs or may have badly formatted inputs or options.
- `500` — Internal server error. Unable to run command.

---

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