v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22216424765.0 KB
gateway.openapi_Gateway

Get account usage (serverless and dedicated deployments). Optionally filter by usage type via the usage_type field. If not specified, returns all usage types.

get/v1/accounts/{account_id}/billingUsage

Path parameters

account_idstring required

The Account Id

Query parameters

startTimestring date-time required

Costs returned are inclusive of start_time. start_time must be before end_time.

endTimestring date-time required

Costs returned are exclusive of end_time. end_time must not be more than 31 days after start_time.

usageType'USAGE_TYPE_UNSPECIFIED' | 'SERVERLESS' | 'DEDICATED_DEPLOYMENT'

Usage type to query usage for If not specified, returns all usage types (both serverless and dedicated deployments).

  • USAGE_TYPE_UNSPECIFIED: Default value. When specified (or when usage_type field is not set), returns usage data for all deployment types: both serverless requests and dedicated deployments.
  • SERVERLESS: Returns only serverless usage data. Filters the response to include only usage from serverless API requests.
  • DEDICATED_DEPLOYMENT: Returns only dedicated deployment usage data. Filters the response to include only usage from dedicated deployments.
timezonestring

IANA timezone identifier for daily aggregation (e.g., "America/Los_Angeles", "Europe/London"). When specified, the returned data will be aggregated into daily buckets based on this timezone. If not specified or empty, defaults to "UTC". See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Response

A successful response.