v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB

Usage Metering

Get usage across your account

Get all usage across your account.

For SDK users only: all fields on UsageSummaryResponse, UsageSummaryDate, and UsageSummaryDateOrg are accessible through each object's additionalProperties map. Existing typed-field getters are unchanged. New billing dimensions will not have typed-field getters. Use Get available fields for usage summary to enumerate every available key at each response level.

This endpoint is only accessible for parent-level organizations.

get/api/v1/usage/summary

Query parameters

start_monthstring date-time required

Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage beginning in this month. Maximum of 15 months ago.

end_monthstring date-time

Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage ending this month.

include_org_detailsboolean

Include usage summaries for each sub-org.

include_connected_accountsboolean

Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to false.