--- title: Get estimated cost across your account description: Get estimated cost across multi-org and single root-org accounts. breadcrumbs: Docs > API > Get estimated cost across your account --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # Get estimated cost across your account ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/usage/estimated_cost | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/usage/estimated_cost | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/usage/estimated_cost | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/usage/estimated_cost | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/usage/estimated_cost | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/usage/estimated_cost | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/usage/estimated_cost | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/usage/estimated_cost | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/usage/estimated_cost | ### Overview Get estimated cost across multi-org and single root-org accounts. Estimated cost data is only available for the current month and previous month and is delayed by up to 72 hours from when it was incurred. To access historical costs prior to this, use the `/historical_cost` endpoint. This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization.md). This endpoint requires all of the following permissions: - `usage_read` - `billing_read` OAuth apps require the `usage_read`, `billing_read` authorization [scope](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/scopes.md#usage-metering) to access this endpoint. ### Arguments #### Query Strings | Field | Type | Description | | -------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | view | string | String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`. | | start_month | string | Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. **Either start\_month or start\_date should be specified, but not both.** (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost. | | end_month | string | Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month. | | start_date | string | Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. **Either start\_month or start\_date should be specified, but not both.** (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost. | | end_date | string | Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day. | | cost_aggregation | enum | Controls how costs are aggregated when using `start_date`. The `cumulative` option returns month-to-date running totals. Allowed enum values: `cumulative`. | | 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`. Default: `false`. | ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} Chargeback Summary response. | Parent field | Field | Type | Description | | ------------ | ----------------- | --------- | ------------------------------------------------------------------------------ | | | data | [object] | Response containing Chargeback Summary. | | data | attributes | object | Cost attributes data. | | attributes | account_name | string | The account name. | | attributes | account_public_id | string | The account public ID. | | attributes | charges | [object] | List of charges data reported for the requested month. | | charges | charge_type | string | The type of charge for a particular product. | | charges | cost | double | The cost for a particular product and charge type during a given month. | | charges | product_name | string | The product for which cost is being reported. | | attributes | date | date-time | The month requested. | | attributes | org_name | string | The organization name. | | attributes | public_id | string | The organization public ID. | | attributes | region | string | The region of the Datadog instance that the organization belongs to. | | attributes | total_cost | double | The total cost of products for the month. | | data | id | string | Unique ID of the response. | | data | type | enum | Type of cost data. Allowed enum values: `cost_by_org`. Default: `cost_by_org`. | {% /tab %} {% tab label="Example" %} ```json { "data": [ { "attributes": { "account_name": "string", "account_public_id": "string", "charges": [ { "charge_type": "on_demand", "cost": "number", "product_name": "infra_host" } ], "date": "2019-09-19T10:00:00.000Z", "org_name": "string", "public_id": "string", "region": "string", "total_cost": "number" }, "id": "string", "type": "cost_by_org" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="403" %} Forbidden - User is not authorized {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com # Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" curl -X GET "https://api.${DD_SITE}/api/v2/usage/estimated_cost" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ``` {% /tab %} {% tab label="Go" %} ```go // Get estimated cost across your account returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewUsageMeteringApi(apiClient) resp, r, err := api.GetEstimatedCostByOrg(ctx, *datadogV2.NewGetEstimatedCostByOrgOptionalParameters()) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `UsageMeteringApi.GetEstimatedCostByOrg`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `UsageMeteringApi.GetEstimatedCostByOrg`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Get estimated cost across your account returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.UsageMeteringApi; import com.datadog.api.client.v2.model.CostByOrgResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); UsageMeteringApi apiInstance = new UsageMeteringApi(defaultClient); try { CostByOrgResponse result = apiInstance.getEstimatedCostByOrg(); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling UsageMeteringApi#getEstimatedCostByOrg"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Get estimated cost across your account returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.usage_metering_api import UsageMeteringApi configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = UsageMeteringApi(api_client) response = api_instance.get_estimated_cost_by_org() print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Get estimated cost across your account returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::UsageMeteringAPI.new p api_instance.get_estimated_cost_by_org() ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Get estimated cost across your account returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_usage_metering::GetEstimatedCostByOrgOptionalParams; use datadog_api_client::datadogV2::api_usage_metering::UsageMeteringAPI; #[tokio::main] async fn main() { let configuration = datadog::Configuration::new(); let api = UsageMeteringAPI::with_config(configuration); let resp = api .get_estimated_cost_by_org(GetEstimatedCostByOrgOptionalParams::default()) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Get estimated cost across your account returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.UsageMeteringApi(configuration); apiInstance .getEstimatedCostByOrg() .then((data: v2.CostByOrgResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" ``` {% /tab %} {% /tabs %}