Skip to main content
GET
Files generated over time

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Query Parameters

from
string

Range start, inclusive. YYYY-MM-DD (local midnight in timezone), a local date-time (2026-09-01T09:30), or an ISO 8601 instant with offset. Default: to minus 30 days. Ranges are limited to 366 days.

Maximum string length: 40
to
string

Range end, exclusive. Same formats as from. Default is now.

Maximum string length: 40
timezone
string

IANA timezone used for date-only bounds and calendar buckets. Default UTC.

Maximum string length: 64
tool
string

Filter by capability. Comma-separated tool keys (video, image, speech, music, render, pipeline, ...) or none. Up to 50 values.

Maximum string length: 4000
model
string

Filter by model. Comma-separated model ids or none. Up to 50 values.

Maximum string length: 4000
workspace_id
string

Filter by folder. Comma-separated folder ids or none (no folder). Up to 50 values.

Maximum string length: 4000
api_key_id
string

Filter by the API key that started the run. Comma-separated key ids or none. Up to 50 values.

Maximum string length: 4000
member_id
string

Filter by the person who started the run. Comma-separated user ids or none. Up to 50 values.

Maximum string length: 4000
creator
string

Filter by creator: api_key:<id> (a personal API key) or member:<id> (a person), comma-separated, or none. Up to 50 values.

Maximum string length: 4000
source
string

Filter by how the run was started. Comma-separated values of app (a person in the web app), api (API key, SDK, CLI), mcp (an agent via MCP), internal (varg system keys), unknown.

Maximum string length: 4000
status
string

Filter by the charged job's status. Comma-separated values of completed, failed, cancelled, awaiting_confirmation, running, submitting, queued, unknown.

Maximum string length: 4000
bucket_width
enum<string>

Calendar bucket size in timezone. 1h is limited to ranges of 31 days or less. Default 1d.

Available options:
1h,
1d,
1w,
1mo
format
enum<string>

json (default) returns the { data, meta } envelope. csv returns the same rows as text/csv with a Content-Disposition attachment filename. Amounts are in credits.

Available options:
json,
csv

Response

Result envelope (JSON) or CSV export

data
object
required
meta
object
required

Metadata describing how the numbers were computed.