usage_billable_summary

Creates, updates, deletes, gets or lists a usage_billable_summary resource.

Overview

Name	usage_billable_summary
Type	Resource
Id	datadog.organization.usage_billable_summary

Fields

The following fields are returned by SELECT queries:

get_usage_billable_summary

Name	Datatype	Description
account_public_id	string	The account public ID.
public_id	string	The organization public ID.
account_name	string	The account name.
org_name	string	The organization name.
billing_plan	string	The billing plan (metadata). (Deprecated from June 2026)
end_date	string (date-time)	Shows the last date of usage.
num_orgs	integer (int64)	The number of organizations.
ratio_in_month	number (double)	Shows usage aggregation for a billing period.
region	string	The region of the organization.
start_date	string (date-time)	Shows the first date of usage.
usage	object	Response with aggregated usage types.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_usage_billable_summary	select		month, include_connected_accounts	Get billable usage across your account.<br /><br />This endpoint is only accessible for [parent-level organizations](https:​//docs.datadoghq.com/account_management/multi_organization/).

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
include_connected_accounts	boolean	Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to false.
month	string (date-time)	Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage starting this month.

SELECT examples

get_usage_billable_summary

Get billable usage across your account.<br /><br />This endpoint is only accessible for [parent-level organizations](https:​//docs.datadoghq.com/account_management/multi_organization/).

SELECT
account_public_id,
public_id,
account_name,
org_name,
billing_plan,
end_date,
num_orgs,
ratio_in_month,
region,
start_date,
usage
FROM datadog.organization.usage_billable_summary
WHERE month = '{{ month }}'
AND include_connected_accounts = '{{ include_connected_accounts }}'
;