Cloud Cost Management
List unit costs
List the ROI metrics (unit costs) for the authenticated organization.
get/api/v2/cost/unit_costs
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/token
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
OK
Example response
{
"data": [
{
"attributes": {
"created_at": "2026-09-01T18:46:15.933716Z",
"created_by": "36ea1610-8866-4bd3-bb6d-9bb9fc87cad2",
"denominator_query": {
"formulas": [
{
"formula": "numerator"
}
],
"queries": [
{
"data_source": "cloud_cost",
"name": "numerator",
"query": "sum:aws.cost.net.amortized.shared.resources.allocated{*}.rollup(sum, daily)"
}
]
},
"denominator_type": "metrics",
"description": "Amortized cloud spend divided by the number of active users.",
"name": "Cloud cost per active user",
"numerator_query": {
"formulas": [
{
"formula": "numerator"
}
],
"queries": [
{
"data_source": "cloud_cost",
"name": "numerator",
"query": "sum:aws.cost.net.amortized.shared.resources.allocated{*}.rollup(sum, daily)"
}
]
},
"org_id": 321813,
"unit_label": "user",
"updated_at": "2026-09-01T19:52:08.820536Z",
"updated_by": "13cc0adf-2595-479e-b448-5051c180dddb"
},
"id": "64aecd58-e355-4f07-9c3a-56ff6bda6cd8",
"type": "unit_cost"
}
]
}Changes
Changes to this operation have not been checked yet.