--- title: Get estimated cost across your account description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Usage Metering --- # Get estimated cost across your account{% #get-estimated-cost-across-your-account %} Copy pageCopied {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------- | | 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 | | app.datadoghq.eu | GET https://api.datadoghq.eu/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 | | 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 | ### 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://docs.datadoghq.com/api/latest/scopes.md#usage-metering) to access this endpoint. ### Arguments #### Query Strings | Name | 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`. | ### Response {% tab title="200" %} OK {% tab title="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` | {% /tab %} {% tab title="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 %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden - User is not authorized {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/usage/estimated_cost" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" ##### ```python """ Get estimated cost across your account returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.usage_metering_api import UsageMeteringApi configuration = Configuration() 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://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # Get estimated cost across your account returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V2::UsageMeteringAPI.new p api_instance.get_estimated_cost_by_org() ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```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()) 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://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```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(); 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://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```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://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Get estimated cost across your account returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); 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://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}