List SKUs
Get every generally available Datadog SKU, with the pricing and allotment metadata that applies to it, for the Datadog site serving the request. A SKU is generally available when it is billed through a metered commitment or through automatic billing; SKUs in any other phase are not returned.
Prices, allotments, and pricing tiers are returned as they were in effect on as_of_date, which defaults to the date of the request. Prices are public list prices: they do not reflect discounts, commitments, or negotiated rates on an account.
Each SKU is a separate resource in data, identified by its SKU code, and sorted by that code in ascending order. The whole catalog is returned in a single response, so this endpoint is not paginated.
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/tokenScopesbilling_read
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopesusage_read
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
The version of the product catalog contract to return.
The version of the product catalog response contract to return. v1 is the latest. This is independent of the /api/v2 path segment, which is the version of the Datadog API itself.
The date the returned prices, allotments, and pricing tiers are effective as of, in YYYY-MM-DD format. Defaults to the date of the request, and must not be later than it. Set it to a date in a past billing period to reconcile that period against the prices that were in effect then, rather than today.
Response
OK
Example response
{
"data": [
{
"attributes": {
"allotments": [
{
"child_sku_code": "CUSTOM-EVENTS",
"hourly_quantity": 0.684932,
"monthly_quantity": 500,
"parent_sku_code": "HOSTS-PRO"
}
],
"billing_dimension": "infra_host",
"billing_units": "hosts",
"currency": "USD",
"default_on_demand_option": "monthly",
"number_of_units_included_in_price": 1,
"on_demand_list_price": "18.00",
"on_demand_tiered": {
"tiers": [
{
"max_usage_quantity": 100000,
"min_usage_quantity": 1,
"price": "120.00",
"pricing_unit_type": "unit"
}
]
},
"pricing_type": "usage",
"sku_name": "Infra Host (Pro)"
},
"id": "HOSTS-PRO",
"type": "Sku"
}
]
}Changes
Changes to this operation have not been checked yet.