---
title: "Get estimated cost across your account"
method: GET
path: "/api/v2/usage/estimated_cost"
tags: ["Usage Metering"]
---

# Get estimated cost across your account

`GET /api/v2/usage/estimated_cost`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/usage/estimated_cost`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `usage_read`, `billing_read`

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/).

## Query parameters

- `view` string
- `start_month` string, date-time
- `end_month` string, date-time
- `start_date` string, date-time
- `end_date` string, date-time
- `cost_aggregation` 'cumulative': Controls how costs are aggregated when using `start_date`. The `cumulative` option returns month-to-date running totals.
- `include_connected_accounts` boolean

## Response `200`

OK

- CostByOrgResponse: Chargeback Summary response.
  - `data` CostByOrg[]: Response containing Chargeback Summary.
    - `attributes` CostByOrgAttributes: Cost attributes data.
      - `account_name` string: The account name.
      - `account_public_id` string: The account public ID.
      - `charges` ChargebackBreakdown[]: List of charges data reported for the requested month.
        - `charge_type` string: The type of charge for a particular product.
        - `cost` number, double: The cost for a particular product and charge type during a given month.
        - `product_name` string: The product for which cost is being reported.
      - `date` string, date-time: The month requested.
      - `org_name` string: The organization name.
      - `public_id` string: The organization public ID.
      - `region` string: The region of the Datadog instance that the organization belongs to.
      - `total_cost` number, double: The total cost of products for the month.
    - `id` string: Unique ID of the response.
    - `type` 'cost_by_org': Type of cost data.

## Other responses

- `400`: Bad Request
- `403`: Forbidden - User is not authorized
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)