---
title: "Get daily AI credit usage"
method: GET
path: "/v1/ai_usage/daily"
tags: ["AI Usage"]
---

# Get daily AI credit usage

`GET /v1/ai_usage/daily`

Returns per-user, per-day AI credit usage for the plan associated with the calling token. This endpoint requires a plan access token with the `org:ai_metering_usage_read` scope.

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `user_email` string
- `limit` integer
- `cursor` string

## Response `200`

Response from the GET /v1/ai_usage/daily endpoint.

- object
  - `rows` AiUsageDailyRow[], required — Per-user, per-day AI credit usage aggregates, ordered by `day`, then user, then `editor_type`.
    - `plan_id` string, required — The id of the plan the usage belongs to.
    - `user_id` string, required — The id of the Figma user that consumed the credits.
    - `user_email` string, nullable — The email of the Figma user that consumed the credits, or `null` when the user's email could not be resolved (e.g. a deleted user).
    - `day` string, required — The calendar date (UTC) of the aggregated usage, in `YYYY-MM-DD` format.
    - `editor_type` 'design' | 'figjam' | 'slides' | 'sites' | 'buzz' | 'make' | 'not_applicable', required — The editor the AI action was associated with. `not_applicable` when the underlying AI action had no associated file.
    - `seat_credits_sum` integer, required — The sum of seat-level (per-user-allocated) credits consumed for this day, user, and editor type.
    - `plan_credits_sum` integer, required — The sum of plan-level (shared pool) credits consumed for this day, user, and editor type.
    - `workspace_id` string, nullable — The id of the workspace the usage was attributed to, or `null` when the usage had no associated workspace.
    - `workspace_name` string, nullable — The name of the workspace the usage was attributed to, or `null` when the usage had no associated workspace.
    - `team_id` string, nullable — The id of the team the usage was attributed to, or `null` when the usage had no associated team.
    - `team_name` string, nullable — The name of the team the usage was attributed to, or `null` when the usage had no associated team.
    - `license_group_id` string, nullable — The id of the license group the usage was attributed to, or `null` when the usage had no associated license group.
    - `license_group_name` string, nullable — The name of the license group the usage was attributed to, or `null` when the usage had no associated license group.
    - `metering_period_start` string, required — The start of the plan-scoped metering period this usage belongs to, as an RFC 3339 UTC timestamp (e.g. `2026-05-01T00:00:00Z`).
    - `metering_period_end` string, required — The end of the plan-scoped metering period this usage belongs to, as an RFC 3339 UTC timestamp (e.g. `2026-06-01T00:00:00Z`).
  - `next_cursor` string, required — An opaque cursor to pass as the `cursor` query parameter to fetch the next page. Empty when there are no more pages.
  - `has_next_page` boolean, required — Whether there is a next page of results to fetch.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `401` — Token is missing or incorrect.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

- **2026-07-01** `06c46b4a1273` — 1 info
  - endpoint added
- **2023-12-14** `de5c0106668d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v1/ai_usage/daily/get.md)

---

[API](https://skmtc.dev/figma/apis/figma-api.md) · [All operations](https://skmtc.dev/figma/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/figma/figma-api/revisions/d7ab5681d84c/schema)