v1

latestOpenAPI 3.1.02026-07-1750229379.2 KB

AI Usage

Get daily AI credit usage

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.

get/v1/ai_usage/daily

Query parameters

start_datestring required

The first day to include, inclusive, as a YYYY-MM-DD calendar date (UTC). Required. Must be on or after 2025-12-01 and no more than 366 days before the current UTC day.

end_datestring required

The last day to include, inclusive, as a YYYY-MM-DD calendar date (UTC). Required. Must be on or after start_date and the current UTC day or earlier.

user_emailstring

Restrict the results to a single Figma user, identified by email. When omitted, rows for every user in the plan with usage in the range are returned. An email that matches no Figma user returns a 400.

limitinteger

Maximum number of rows to return. This param defaults to 1000 if unspecified, and may not exceed 1000.

cursorstring

An opaque cursor returned from a previous request, used for pagination.

Response

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

next_cursorstring 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_pageboolean required

Whether there is a next page of results to fetch.