Sign in
organizations

Return total spend and event count for the organization.

get/v1/organizations/billing/usage/totals/

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).

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

total_usdstring required

Total spend in USD as a decimal string.

event_countinteger required

Number of usage events.

Changes

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