GetBillingDimensionMapping

Retrieve billing dimension mappings for supported usage metering API endpoints. Specify active or all mappings with optional month filters, updated monthly for parent-level organizations.

Instructions

Get a mapping of billing dimensions to the corresponding keys for the supported usage metering public API endpoints. Mapping data is updated on a monthly cadence.

This endpoint is only accessible to parent-level organizations.

Query Parameters:

filter[month]: Datetime in ISO-8601 format, UTC, and for mappings beginning this month. Defaults to the current month.
filter[view]: String to specify whether to retrieve active billing dimension mappings for the contract or for all available mappings. Allowed views have the string active or all. Defaults to active.

Responses:

200 (Success): OK
- Content-Type: application/json;datetime-format=rfc3339
- Response Properties:
- Example:

{ "data": "unknown_type" }

400: Bad Request
- Content-Type: application/json;datetime-format=rfc3339
- Response Properties:
  - errors: A list of errors.
- Example:

{ "errors": [ "Bad Request" ] }

403: Forbidden - User is not authorized
- Content-Type: application/json;datetime-format=rfc3339
- Response Properties:
  - errors: A list of errors.
- Example:

{ "errors": [ "Bad Request" ] }

429: Too many requests
- Content-Type: application/json;datetime-format=rfc3339
- Response Properties:
  - errors: A list of errors.
- Example:

{ "errors": [ "Bad Request" ] }

Input Schema

Name	Required	Description	Default
`filter[month]`	No	Datetime in ISO-8601 format, UTC, and for mappings beginning this month. Defaults to the current month.
`filter[view]`	No	String to specify whether to retrieve active billing dimension mappings for the contract or for all available mappings. Allowed views have the string `active` or `all`. Defaults to `active`.	active

Input Schema (JSON Schema)

{ "properties": { "filter[month]": { "description": "Datetime in ISO-8601 format, UTC, and for mappings beginning this month. Defaults to the current month.", "format": "date-time", "type": "string" }, "filter[view]": { "default": "active", "description": "String to specify whether to retrieve active billing dimension mappings for the contract or for all available mappings. Allowed views have the string `active` or `all`. Defaults to `active`.", "type": "string" } }, "required": [], "type": "object" }

Datadog MCP Server