{ "opencollection": "1.0.0", "info": { "name": "Datadog Account Cost API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "items": [ { "info": { "name": "Cost", "type": "folder" }, "items": [ { "info": { "name": "Datadog List Cloud Cost Management Aws Cur Configs", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/cost/aws_cur_config", "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "List the AWS CUR configs." }, { "info": { "name": "Datadog Create Cloud Cost Management Aws Cur Config", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/cost/aws_cur_config", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Create a Cloud Cost Management account for an AWS CUR config." }, { "info": { "name": "Datadog Update Cloud Cost Management Aws Cur Config", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/cost/aws_cur_config/:cloud_account_id", "params": [ { "name": "cloud_account_id", "value": "", "type": "path", "description": "Cloud Account id." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Update the status (active/archived) and/or account filtering configuration of an AWS CUR config." }, { "info": { "name": "Datadog Delete Cloud Cost Management Aws Cur Config", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/cost/aws_cur_config/:cloud_account_id", "params": [ { "name": "cloud_account_id", "value": "", "type": "path", "description": "Cloud Account id." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Archive a Cloud Cost Management Account." }, { "info": { "name": "Datadog List Cloud Cost Management Azure Configs", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/cost/azure_uc_config", "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "List the Azure configs." }, { "info": { "name": "Datadog Create Cloud Cost Management Azure Configs", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/cost/azure_uc_config", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Create a Cloud Cost Management account for an Azure config." }, { "info": { "name": "Datadog Update Cloud Cost Management Azure Config", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/cost/azure_uc_config/:cloud_account_id", "params": [ { "name": "cloud_account_id", "value": "", "type": "path", "description": "Cloud Account id." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Update the status of an Azure config (active/archived)." }, { "info": { "name": "Datadog Delete Cloud Cost Management Azure Config", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/cost/azure_uc_config/:cloud_account_id", "params": [ { "name": "cloud_account_id", "value": "", "type": "path", "description": "Cloud Account id." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Archive a Cloud Cost Management Account." }, { "info": { "name": "Datadog Get Active Billing Dimensions for Cost Attribution", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/cost_by_tag/active_billing_dimensions", "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get active billing dimensions for cost attribution. Cost data for a given month becomes available no later than the 19th of the following month." }, { "info": { "name": "Datadog Get Monthly Cost Attribution", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/cost_by_tag/monthly_cost_attribution", "params": [ { "name": "start_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning in this month." }, { "name": "end_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month." }, { "name": "fields", "value": "example_value", "type": "query", "description": "Comma-separated list specifying cost types (e.g., `_on_demand_cost`, `_committed_cost`, `_total_cost`) and the\nproportions (`_percentage_in_org`, `_percentage_in_account`). Use `*` to retrieve all fields.\nExample: `infra_host_on_demand_cost,infra_host_percentage_in_account`\nTo obtain the complete list of active billing dimensions that can be used to replace\n`` in the field names, make a request to the [Get active billing dimensions API](https://docs.datadoghq.com/api/latest/usage-metering/#get-active-billing-dimensions-for-cost-attribution)." }, { "name": "sort_direction", "value": "example_value", "type": "query", "description": "The direction to sort by: `[desc, asc]`." }, { "name": "sort_name", "value": "Example Monitor", "type": "query", "description": "The billing dimension to sort by. Always sorted by total cost. Example: `infra_host`." }, { "name": "tag_breakdown_keys", "value": "env:production", "type": "query", "description": "Comma separated list of tag keys used to group cost. If no value is provided the cost will not be broken down by tags.\nTo see which tags are available, look for the value of `tag_config_source` in the API response." }, { "name": "next_record_id", "value": "abc-123-def", "type": "query", "description": "List following results with a next_record_id provided in the previous query." }, { "name": "include_descendants", "value": "true", "type": "query", "description": "Include child org cost in the response. Defaults to `true`." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get monthly cost attribution by tag across multi-org and single root-org accounts.\nCost Attribution data for a given month becomes available no later than the 19th of the following month.\nThis API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is\nset in the response. If it is, make another request and pass `next_record_id` as a parameter.\nPseudo code example:\n```\nresponse := GetMonthlyCostAttribution(start_month, end_month)\ncursor := response." }, { "info": { "name": "Datadog Get Cost Across Multi-org Account", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/usage/cost_by_org", "params": [ { "name": "start_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month." }, { "name": "end_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get cost across multi-org account.\nCost by org data for a given month becomes available no later than the 16th of the following month.\n**Note:** This endpoint has been deprecated. Please use the new endpoint\n[`/historical_cost`](https://docs.datadoghq.com/api/latest/usage-metering/#get-historical-cost-across-your-account)\ninstead.\n\nThis endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/)." }, { "info": { "name": "Datadog Get Estimated Cost Across Your Account", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/usage/estimated_cost", "params": [ { "name": "view", "value": "example_value", "type": "query", "description": "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`." }, { "name": "start_month", "value": "example_value", "type": "query", "description": "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." }, { "name": "end_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month." }, { "name": "start_date", "value": "2026-04-17T12:00:00Z", "type": "query", "description": "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." }, { "name": "end_date", "value": "2026-04-17T12:00:00Z", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day." }, { "name": "include_connected_accounts", "value": "true", "type": "query", "description": "Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to `false`. " } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get estimated cost across multi-org and single root-org accounts.\nEstimated cost data is only available for the current month and previous month\nand is delayed by up to 72 hours from when it was incurred.\nTo access historical costs prior to this, use the `/historical_cost` endpoint.\n\nThis endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/)." }, { "info": { "name": "Datadog Get Historical Cost Across Your Account", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/usage/historical_cost", "params": [ { "name": "view", "value": "example_value", "type": "query", "description": "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`." }, { "name": "start_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month." }, { "name": "end_month", "value": "example_value", "type": "query", "description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month." }, { "name": "include_connected_accounts", "value": "true", "type": "query", "description": "Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to `false`. " } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get historical cost across multi-org and single root-org accounts.\nCost data for a given month becomes available no later than the 16th of the following month.\n\nThis endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/)." }, { "info": { "name": "Datadog Get Projected Cost Across Your Account", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/usage/projected_cost", "params": [ { "name": "view", "value": "example_value", "type": "query", "description": "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`." }, { "name": "include_connected_accounts", "value": "true", "type": "query", "description": "Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to `false`. " } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get projected cost across multi-org and single root-org accounts.\nProjected cost data is only available for the current month and becomes available around the 12th of the month.\n\nThis endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/)." } ] } ], "bundled": true }