Skip to main content
GET
Get usage
from and to are UTC days, inclusive. The default is the last 30 days; the most is 366 days. total is what you really spent: refunds are taken off. by_source splits it into skill_runs, workflows, browser_sessions, assistant, browser_agents, ai_tools, improvements, and other. days lists each day with any usage, oldest first. Credits given back for old over-charges are not usage; they are in goodwill_refunds. Amounts are decimal strings, exact to 0.01. Needs account:read. MCP tool: get_usage. Each run’s own cost is on Get a run.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Query Parameters

from
string<date> | null

First UTC day (default 30 days ago).

to
string<date> | null

Last UTC day, inclusive (default today).

Response

Your usage.

from
string
required
to
string
required
total
string
required

Net credits spent in the range (refunds taken off), exact to 0.01.

by_source
By Source · object
required

Credits per source: skill_runs, workflows, browser_sessions, assistant, browser_agents, ai_tools, improvements, other.

days
UsageDay · object[]
required

Days with any usage, oldest first.

timezone
string
default:UTC
goodwill_refunds
string
default:0.00

Credits given back in the range for old over-charges (not counted as usage).