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

# Get Usage

`GET /v1/me/usage`

Get usage for the current user.

## Query parameters

- `offset` integer — The offset of the usages to get.
- `limit` integer — The limit of the usages to get.
- `start_time` integer, nullable — Start time as Unix timestamp (if not provided, will be set to 30 days ago)
- `end_time` integer, nullable — End time as Unix timestamp (if not provided, will be set to now)
- `endpoint` '/v1/audio/transcriptions' | '/v1/chat/completions' | '/v1/embeddings' | '/v1/ocr' | '/v1/rerank' | '/v1/search'

## Response `200`

Successful Response

- Usages
  - `object` 'list' — Object type.
  - `data` ApiSchemasMeUsageUsage[], required — List of usages.
    - `object` 'me.usage' — Object type.
    - `model` string, nullable — Model used for the request.
    - `key` string, nullable — Key used for the request.
    - `endpoint` string, nullable — Endpoint used for the request.
    - `method` string, nullable — Method used for the request.
    - `status` integer, nullable — Status code of the response.
    - `usage` UsageDetail
      - `prompt_tokens` integer, nullable — Number of prompt tokens (e.g. input tokens).
      - `completion_tokens` integer, nullable — Number of completion tokens (e.g. output tokens).
      - `total_tokens` integer, nullable — Total number of tokens (e.g. input and output tokens).
      - `cost` number, nullable — Total cost of the request.
      - `impacts` ApiSchemasUsageEnvironmentalImpacts
        - `kWh` number — Carbon footprint in kWh.
        - `kgCO2eq` number — Carbon footprint in kgCO2eq (global warming potential).
      - `metrics` MetricsUsage
        - `latency` integer, nullable
        - `ttft` integer, nullable
    - `created` integer, required — Timestamp in seconds

## Other responses

- `422` — Validation Error

---

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