---
title: "Get monthly usage attribution"
method: GET
path: "/api/v1/usage/monthly-attribution"
tags: ["Usage Metering"]
---

# Get monthly usage attribution

`GET /api/v1/usage/monthly-attribution`

Get monthly usage attribution. Multi-region data is available starting March 1, 2023.

This API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is
set in the response. If it is, make another request and pass `next_record_id` as a parameter.
Pseudo code example:

```
response := GetMonthlyUsageAttribution(start_month)
cursor := response.metadata.pagination.next_record_id
WHILE cursor != null BEGIN
  sleep(5 seconds)  # Avoid running into rate limit
  response := GetMonthlyUsageAttribution(start_month, next_record_id=cursor)
  cursor := response.metadata.pagination.next_record_id
END
```

## Query parameters

- `start_month` string, date-time, required
- `end_month` string, date-time
- `fields` 'api_usage' | 'api_percentage' | 'apm_fargate_usage' | 'apm_fargate_percentage' | 'appsec_fargate_usage' | 'appsec_fargate_percentage' | 'apm_host_usage' | 'apm_host_percentage' | 'apm_usm_usage' | 'apm_usm_percentage' | 'appsec_usage' | 'appsec_percentage' | 'asm_serverless_traced_invocations_usage' | 'asm_serverless_traced_invocations_percentage' | 'bits_ai_investigations_usage' | 'bits_ai_investigations_percentage' | 'browser_usage' | 'browser_percentage' | 'ci_visibility_itr_usage' | 'ci_visibility_itr_percentage' | 'cloud_siem_usage' | 'cloud_siem_percentage' | 'code_security_host_usage' | 'code_security_host_percentage' | 'container_excl_agent_usage' | 'container_excl_agent_percentage' | 'container_usage' | 'container_percentage' | 'cspm_containers_percentage' | 'cspm_containers_usage' | 'cspm_hosts_percentage' | 'cspm_hosts_usage' | 'custom_timeseries_usage' | 'custom_timeseries_percentage' | 'custom_ingested_timeseries_usage' | 'custom_ingested_timeseries_percentage' | 'cws_containers_percentage' | 'cws_containers_usage' | 'cws_fargate_task_percentage' | 'cws_fargate_task_usage' | 'cws_hosts_percentage' | 'cws_hosts_usage' | 'data_jobs_monitoring_usage' | 'data_jobs_monitoring_percentage' | 'data_stream_monitoring_usage' | 'data_stream_monitoring_percentage' | 'dbm_hosts_percentage' | 'dbm_hosts_usage' | 'dbm_queries_percentage' | 'dbm_queries_usage' | 'error_tracking_usage' | 'error_tracking_percentage' | 'estimated_indexed_spans_usage' | 'estimated_indexed_spans_percentage' | 'estimated_ingested_spans_usage' | 'estimated_ingested_spans_percentage' | 'fargate_usage' | 'fargate_percentage' | 'flex_logs_starter_usage' | 'flex_logs_starter_percentage' | 'flex_stored_logs_usage' | 'flex_stored_logs_percentage' | 'functions_usage' | 'functions_percentage' | 'incident_management_monthly_active_users_usage' | 'incident_management_monthly_active_users_percentage' | 'infra_host_usage' | 'infra_host_percentage' | 'infra_host_basic_usage' | 'infra_host_basic_percentage' | 'invocations_usage' | 'invocations_percentage' | 'lambda_traced_invocations_usage' | 'lambda_traced_invocations_percentage' | 'llm_observability_usage' | 'llm_observability_percentage' | 'llm_spans_usage' | 'llm_spans_percentage' | 'mobile_app_testing_percentage' | 'mobile_app_testing_usage' | 'ndm_netflow_usage' | 'ndm_netflow_percentage' | 'network_device_wireless_usage' | 'network_device_wireless_percentage' | 'npm_host_usage' | 'npm_host_percentage' | 'obs_pipeline_bytes_usage' | 'obs_pipeline_bytes_percentage' | 'obs_pipelines_vcpu_usage' | 'obs_pipelines_vcpu_percentage' | 'online_archive_usage' | 'online_archive_percentage' | 'product_analytics_session_usage' | 'product_analytics_session_percentage' | 'profiled_container_usage' | 'profiled_container_percentage' | 'profiled_fargate_usage' | 'profiled_fargate_percentage' | 'profiled_host_usage' | 'profiled_host_percentage' | 'published_app_usage' | 'published_app_percentage' | 'serverless_apps_usage' | 'serverless_apps_percentage' | 'serverless_apps_apm_usage' | 'serverless_apps_apm_percentage' | 'snmp_usage' | 'snmp_percentage' | 'universal_service_monitoring_usage' | 'universal_service_monitoring_percentage' | 'vuln_management_hosts_usage' | 'vuln_management_hosts_percentage' | 'sds_scanned_bytes_usage' | 'sds_scanned_bytes_percentage' | 'ci_test_indexed_spans_usage' | 'ci_test_indexed_spans_percentage' | 'ingested_logs_bytes_usage' | 'ingested_logs_bytes_percentage' | 'ci_pipeline_indexed_spans_usage' | 'ci_pipeline_indexed_spans_percentage' | 'indexed_spans_usage' | 'indexed_spans_percentage' | 'custom_event_usage' | 'custom_event_percentage' | 'logs_indexed_custom_retention_usage' | 'logs_indexed_custom_retention_percentage' | 'logs_indexed_360day_usage' | 'logs_indexed_360day_percentage' | 'logs_indexed_180day_usage' | 'logs_indexed_180day_percentage' | 'logs_indexed_90day_usage' | 'logs_indexed_90day_percentage' | 'logs_indexed_60day_usage' | 'logs_indexed_60day_percentage' | 'logs_indexed_45day_usage' | 'logs_indexed_45day_percentage' | 'logs_indexed_30day_usage' | 'logs_indexed_30day_percentage' | 'logs_indexed_15day_usage' | 'logs_indexed_15day_percentage' | 'logs_indexed_7day_usage' | 'logs_indexed_7day_percentage' | 'logs_indexed_3day_usage' | 'logs_indexed_3day_percentage' | 'logs_indexed_1day_usage' | 'logs_indexed_1day_percentage' | 'rum_ingested_usage' | 'rum_ingested_percentage' | 'rum_investigate_usage' | 'rum_investigate_percentage' | 'rum_replay_sessions_usage' | 'rum_replay_sessions_percentage' | 'rum_session_replay_add_on_usage' | 'rum_session_replay_add_on_percentage' | 'rum_browser_mobile_sessions_usage' | 'rum_browser_mobile_sessions_percentage' | 'ingested_spans_bytes_usage' | 'ingested_spans_bytes_percentage' | 'siem_12mo_retention_usage' | 'siem_12mo_retention_percentage' | 'siem_6mo_retention_usage' | 'siem_6mo_retention_percentage' | 'siem_analyzed_logs_add_on_usage' | 'siem_analyzed_logs_add_on_percentage' | 'siem_ingested_bytes_usage' | 'siem_ingested_bytes_percentage' | 'workflow_executions_usage' | 'workflow_executions_percentage' | 'sca_fargate_usage' | 'sca_fargate_percentage' | '*', required — Supported metrics for monthly usage attribution requests. Usage types are in the format `<usage_type>_usage`. To obtain the complete list of valid usage types, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
- `sort_direction` 'desc' | 'asc' — The direction to sort by.
- `sort_name` 'api_usage' | 'api_percentage' | 'apm_fargate_usage' | 'apm_fargate_percentage' | 'appsec_fargate_usage' | 'appsec_fargate_percentage' | 'apm_host_usage' | 'apm_host_percentage' | 'apm_usm_usage' | 'apm_usm_percentage' | 'appsec_usage' | 'appsec_percentage' | 'asm_serverless_traced_invocations_usage' | 'asm_serverless_traced_invocations_percentage' | 'bits_ai_investigations_usage' | 'bits_ai_investigations_percentage' | 'browser_usage' | 'browser_percentage' | 'ci_visibility_itr_usage' | 'ci_visibility_itr_percentage' | 'cloud_siem_usage' | 'cloud_siem_percentage' | 'code_security_host_usage' | 'code_security_host_percentage' | 'container_excl_agent_usage' | 'container_excl_agent_percentage' | 'container_usage' | 'container_percentage' | 'cspm_containers_percentage' | 'cspm_containers_usage' | 'cspm_hosts_percentage' | 'cspm_hosts_usage' | 'custom_timeseries_usage' | 'custom_timeseries_percentage' | 'custom_ingested_timeseries_usage' | 'custom_ingested_timeseries_percentage' | 'cws_containers_percentage' | 'cws_containers_usage' | 'cws_fargate_task_percentage' | 'cws_fargate_task_usage' | 'cws_hosts_percentage' | 'cws_hosts_usage' | 'data_jobs_monitoring_usage' | 'data_jobs_monitoring_percentage' | 'data_stream_monitoring_usage' | 'data_stream_monitoring_percentage' | 'dbm_hosts_percentage' | 'dbm_hosts_usage' | 'dbm_queries_percentage' | 'dbm_queries_usage' | 'error_tracking_usage' | 'error_tracking_percentage' | 'estimated_indexed_spans_usage' | 'estimated_indexed_spans_percentage' | 'estimated_ingested_spans_usage' | 'estimated_ingested_spans_percentage' | 'fargate_usage' | 'fargate_percentage' | 'flex_logs_starter_usage' | 'flex_logs_starter_percentage' | 'flex_stored_logs_usage' | 'flex_stored_logs_percentage' | 'functions_usage' | 'functions_percentage' | 'incident_management_monthly_active_users_usage' | 'incident_management_monthly_active_users_percentage' | 'infra_host_usage' | 'infra_host_percentage' | 'infra_host_basic_usage' | 'infra_host_basic_percentage' | 'invocations_usage' | 'invocations_percentage' | 'lambda_traced_invocations_usage' | 'lambda_traced_invocations_percentage' | 'llm_observability_usage' | 'llm_observability_percentage' | 'llm_spans_usage' | 'llm_spans_percentage' | 'mobile_app_testing_percentage' | 'mobile_app_testing_usage' | 'ndm_netflow_usage' | 'ndm_netflow_percentage' | 'network_device_wireless_usage' | 'network_device_wireless_percentage' | 'npm_host_usage' | 'npm_host_percentage' | 'obs_pipeline_bytes_usage' | 'obs_pipeline_bytes_percentage' | 'obs_pipelines_vcpu_usage' | 'obs_pipelines_vcpu_percentage' | 'online_archive_usage' | 'online_archive_percentage' | 'product_analytics_session_usage' | 'product_analytics_session_percentage' | 'profiled_container_usage' | 'profiled_container_percentage' | 'profiled_fargate_usage' | 'profiled_fargate_percentage' | 'profiled_host_usage' | 'profiled_host_percentage' | 'published_app_usage' | 'published_app_percentage' | 'serverless_apps_usage' | 'serverless_apps_percentage' | 'serverless_apps_apm_usage' | 'serverless_apps_apm_percentage' | 'snmp_usage' | 'snmp_percentage' | 'universal_service_monitoring_usage' | 'universal_service_monitoring_percentage' | 'vuln_management_hosts_usage' | 'vuln_management_hosts_percentage' | 'sds_scanned_bytes_usage' | 'sds_scanned_bytes_percentage' | 'ci_test_indexed_spans_usage' | 'ci_test_indexed_spans_percentage' | 'ingested_logs_bytes_usage' | 'ingested_logs_bytes_percentage' | 'ci_pipeline_indexed_spans_usage' | 'ci_pipeline_indexed_spans_percentage' | 'indexed_spans_usage' | 'indexed_spans_percentage' | 'custom_event_usage' | 'custom_event_percentage' | 'logs_indexed_custom_retention_usage' | 'logs_indexed_custom_retention_percentage' | 'logs_indexed_360day_usage' | 'logs_indexed_360day_percentage' | 'logs_indexed_180day_usage' | 'logs_indexed_180day_percentage' | 'logs_indexed_90day_usage' | 'logs_indexed_90day_percentage' | 'logs_indexed_60day_usage' | 'logs_indexed_60day_percentage' | 'logs_indexed_45day_usage' | 'logs_indexed_45day_percentage' | 'logs_indexed_30day_usage' | 'logs_indexed_30day_percentage' | 'logs_indexed_15day_usage' | 'logs_indexed_15day_percentage' | 'logs_indexed_7day_usage' | 'logs_indexed_7day_percentage' | 'logs_indexed_3day_usage' | 'logs_indexed_3day_percentage' | 'logs_indexed_1day_usage' | 'logs_indexed_1day_percentage' | 'rum_ingested_usage' | 'rum_ingested_percentage' | 'rum_investigate_usage' | 'rum_investigate_percentage' | 'rum_replay_sessions_usage' | 'rum_replay_sessions_percentage' | 'rum_session_replay_add_on_usage' | 'rum_session_replay_add_on_percentage' | 'rum_browser_mobile_sessions_usage' | 'rum_browser_mobile_sessions_percentage' | 'ingested_spans_bytes_usage' | 'ingested_spans_bytes_percentage' | 'siem_12mo_retention_usage' | 'siem_12mo_retention_percentage' | 'siem_6mo_retention_usage' | 'siem_6mo_retention_percentage' | 'siem_analyzed_logs_add_on_usage' | 'siem_analyzed_logs_add_on_percentage' | 'siem_ingested_bytes_usage' | 'siem_ingested_bytes_percentage' | 'workflow_executions_usage' | 'workflow_executions_percentage' | 'sca_fargate_usage' | 'sca_fargate_percentage' | '*' — Supported metrics for monthly usage attribution requests. Usage types are in the format `<usage_type>_usage`. To obtain the complete list of valid usage types, make a request to the [Get usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).
- `tag_breakdown_keys` string
- `next_record_id` string
- `include_descendants` boolean

## Response `200`

OK

## Other responses

- `403` — Forbidden - User is not authorized
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/versions/ca5871004d26/schema)