DAdatadog
Usage Metering

List usage quotas

Lists usage quotas for the caller's organization in a quota namespace. You can optionally include descendant organizations in the same datacenter as the caller. Requires the billing_read or billing_edit permission.

get/api/v2/usage/quotas/{quota_namespace}

Request

Path parameters

quota_namespacestring required
Example:ai_credits

The product-specific namespace whose usage quotas are being managed.

Query parameters

include_descendantsboolean

Whether to include quotas configured on descendant organizations in the caller's organization hierarchy. Only descendants in the same datacenter are supported.

page[cursor]string

An opaque cursor from a previous response's meta.page.next_cursor used to retrieve the next page.

page[limit]integer

The number of usage quotas to return per page.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "enforced": true,
        "org_public_id": "abcdef12345",
        "pending_effective_from": "2026-11",
        "pending_usage_limit": 50000,
        "scope": {
          "user_handle": "jane@example.com"
        },
        "usage_limit": 100000
      },
      "id": "MTIzNB9haV9jcmVkaXRzH3VzZXJfaGFuZGxlOl9fQUxMX18",
      "type": "quotas"
    }
  ],
  "meta": {
    "page": {
      "next_cursor": "eyJvZmZzZXQiOjEwMH0="
    }
  }
}

Changes

Changes to this operation have not been checked yet.