Sign in
organizations

Return time-bucketed usage data grouped by a chosen dimension.

get/v1/organizations/billing/usage/series/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie sessionid
    • API key in header X-Session-Token

Query parameters

fromstring required

Inclusive start date (ISO 8601).

granularity'daily' | 'monthly' | 'weekly'

Time bucket granularity: daily (default), weekly, or monthly.

group_by'assistant' | 'inference_profile' | 'inference_provider' | 'llm_call_site' | 'model' | 'oauth_provider' | 'search_provider' | 'usage_source'

Dimension to group by within each bucket (default: usage_source).

inference_profilestring

Filter by runtime-proxy inference profile ID.

inference_providerstring

Filter by LLM inference provider (e.g. anthropic, openai, gemini).

llm_call_sitestring

Filter by runtime-proxy LLM call-site ID (task).

modelstring

Filter by model ID (e.g. claude-opus-4-6).

oauth_providerstring

Filter by OAuth provider (e.g. twitter, hubspot).

search_providerstring

Filter by search provider (e.g. brave).

tostring required

Inclusive end date (ISO 8601).

tzstring

IANA timezone for date-range and bucket boundaries (default: UTC).

usage_source'managed_speech_proxy' | 'oauth_proxy' | 'runtime_proxy' | 'search_proxy'

Filter by usage source: runtime_proxy, oauth_proxy, search_proxy, or managed_speech_proxy.

Headers

Vellum-Organization-Idstring uuid

Required if using Cookie-based or X-Session-Token authentication methods.

Response

Changes

No recorded changes to this operation across all 50 revisions of this API.