How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Datadog Cost API

The Cost API from Datadog — 10 operation(s) for cost.

Datadog Cost API is one of 290 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Cost. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.

This API exposes 14 operations across 10 paths, and defines 53 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.

14 operations 10 paths 53 schemas 2 DELETE8 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://api.datadoghq.com
Authentication
OAuth 2.0, API Key, API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 4

Datadog Cost API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes. An API key is passed in the header as DD-API-KEY (apiKeyAuth). An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth). It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • AuthZ — This API uses OAuth 2 with the implicit grant flow.
  • apiKeyAuth — Your Datadog API Key.
  • appKeyAuth — Your Datadog APP Key.

Paths & Operations 14

Across 10 paths, the API surfaces 14 operations — 2 DELETE, 8 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Cost 14
GET
/api/v2/cost/aws_cur_config
Datadog List Cloud Cost Management Aws Cur Configs
ListCostAWSCURConfigs → 200403429
POST
/api/v2/cost/aws_cur_config
Datadog Create Cloud Cost Management Aws Cur Config
CreateCostAWSCURConfig body → 200400403429
DELETE
/api/v2/cost/aws_cur_config/{cloud_account_id}
Datadog Delete Cloud Cost Management Aws Cur Config
DeleteCostAWSCURConfig 1 param → 204400404429
PATCH
/api/v2/cost/aws_cur_config/{cloud_account_id}
Datadog Update Cloud Cost Management Aws Cur Config
UpdateCostAWSCURConfig 1 param body → 200403429
GET
/api/v2/cost/azure_uc_config
Datadog List Cloud Cost Management Azure Configs
ListCostAzureUCConfigs → 200403429
POST
/api/v2/cost/azure_uc_config
Datadog Create Cloud Cost Management Azure Configs
CreateCostAzureUCConfigs body → 200400403429
DELETE
/api/v2/cost/azure_uc_config/{cloud_account_id}
Datadog Delete Cloud Cost Management Azure Config
DeleteCostAzureUCConfig 1 param → 204400404429
PATCH
/api/v2/cost/azure_uc_config/{cloud_account_id}
Datadog Update Cloud Cost Management Azure Config
UpdateCostAzureUCConfigs 1 param body → 200400403429
GET
/api/v2/cost_by_tag/active_billing_dimensions
Datadog Get Active Billing Dimensions for Cost Attribution
GetActiveBillingDimensions → 200400403429
GET
/api/v2/cost_by_tag/monthly_cost_attribution
Datadog Get Monthly Cost Attribution
GetMonthlyCostAttribution 8 params → 200400403429
GET
/api/v2/usage/cost_by_orgdeprecated
Datadog Get Cost Across Multi-org Account
GetCostByOrg 2 params → 200400403429
GET
/api/v2/usage/estimated_cost
Datadog Get Estimated Cost Across Your Account
GetEstimatedCostByOrg 6 params → 200400403429
GET
/api/v2/usage/historical_cost
Datadog Get Historical Cost Across Your Account
GetHistoricalCostByOrg 4 params → 200400403429
GET
/api/v2/usage/projected_cost
Datadog Get Projected Cost Across Your Account
GetProjectedCost 2 params → 200400403429

Schemas 53

The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are AzureUCConfig (15 properties), AwsCURConfigAttributes (12 properties), CostByOrgAttributes (8 properties), ProjectedCostAttributes (8 properties). Each schema is shown below with its type and property counts.

AwsCURConfig
object
AWS CUR config.
3 properties 2 required
CostByOrgType
string
Type of cost data.
AwsCURConfigPatchRequest
object
AWS CUR config Patch Request.
1 property 1 required
AzureUCConfigPostRequestType
string
Type of Azure config Post Request.
MonthlyCostAttributionPagination
object
The metadata for the current pagination.
1 property
AwsCURConfigType
string
Type of AWS CUR config.
CostByOrg
object
Cost data.
3 properties
ActiveBillingDimensionsResponse
object
Active billing dimensions response.
1 property
CostByOrgResponse
object
Chargeback Summary response.
1 property
SortDirection
string
The direction to sort by.
AzureUCConfigPairAttributes
object
Attributes for Azure config pair.
2 properties 1 required
ProjectedCostAttributes
object
Projected Cost attributes data.
8 properties
APIErrorResponse
object
API error response.
1 property 1 required
AwsCURConfigsResponse
object
List of AWS CUR configs.
1 property
AzureUCConfigPatchRequestType
string
Type of Azure config Patch Request.
CostAttributionType
string
Type of cost attribution data.
AwsCURConfigResponse
object
Response of AWS CUR config.
1 property
MonthlyCostAttributionAttributes
object
Cost Attribution by Tag for a given organization.
7 properties
ProjectedCostType
string
Type of cost data.
BillConfig
object
Bill config.
4 properties 4 required
AwsCURConfigPatchRequestType
string
Type of AWS CUR config Patch Request.
CostAttributionAggregates
array
An array of available aggregates.
AwsCURConfigPostData
object
AWS CUR config Post data.
2 properties 2 required
ProjectedCostResponse
object
Projected Cost response.
1 property
MonthlyCostAttributionResponse
object
Response containing the monthly cost attribution by tag(s).
2 properties
AzureUCConfigPostRequest
object
Azure config Post Request.
1 property 1 required
MonthlyCostAttributionMeta
object
The object containing document metadata.
2 properties
AzureUCConfig
object
Azure config.
15 properties 9 required
AwsCURConfigPatchData
object
AWS CUR config Patch data.
2 properties 2 required
AwsCURConfigPatchRequestAttributes
object
Attributes for AWS CUR config Patch Request.
2 properties
AzureUCConfigsResponse
object
List of Azure accounts with configs.
1 property
AzureUCConfigPostData
object
Azure config Post data.
2 properties 2 required
AwsCURConfigPostRequestType
string
Type of AWS CUR config Post Request.
AzureUCConfigPatchRequest
object
Azure config Patch Request.
1 property 1 required
AzureUCConfigPairType
string
Type of Azure config pair.
AzureUCConfigPatchRequestAttributes
object
Attributes for Azure config Patch Request.
1 property 1 required
AwsCURConfigPostRequestAttributes
object
Attributes for AWS CUR config Post Request.
8 properties 4 required
AccountFilteringConfig
object
The account filtering configuration.
3 properties
AzureUCConfigPairsResponse
object
Response of Azure config pair.
1 property
ActiveBillingDimensionsBody
object
Active billing dimensions data.
3 properties
MonthlyCostAttributionBody
object
Cost data.
3 properties
ChargebackBreakdown
object
Charges breakdown.
3 properties
ActiveBillingDimensionsAttributes
object
List of active billing dimensions.
2 properties
AzureUCConfigPair
object
Azure config pair.
3 properties 2 required
AzureUCConfigPostRequestAttributes
object
Attributes for Azure config Post Request.
6 properties 5 required
CostAttributionTagNames
object
Tag keys and values. A null value here means that the requested tag breakdown cannot be applied because it does not match the [tags configured for usage attrib…
AwsCURConfigPostRequest
object
AWS CUR config Post Request.
1 property 1 required
ActiveBillingDimensionsType
string
Type of active billing dimensions data.
CostAttributionAggregatesBody
object
The object containing the aggregates.
3 properties
CostByOrgAttributes
object
Cost attributes data.
8 properties
AwsCURConfigAttributes
object
Attributes for An AWS CUR config.
12 properties 6 required
ProjectedCost
object
Projected Cost data.
3 properties
AzureUCConfigPatchData
object
Azure config Patch data.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-cost-api-openapi.yml Raw ↑

Other APIs Datadog publishes across the network.

Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
Where this information came from

This is an independent, third-party profile of Datadog Cost API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.