---
title: "List AI Gateway rate limit counter summaries"
method: GET
path: "/api/v2/rate-limits/instances/summary"
tags: ["AI Gateway"]
---

# List AI Gateway rate limit counter summaries

`GET /api/v2/rate-limits/instances/summary`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/rate-limits/instances/summary`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `ai_gateway_config_read`

Aggregate the counters of every template rate limit in the organization in one call, with one summary per template in the order the rate limit list returns them. Each summary is the one the single-template counter summary endpoint returns without split_dim, including scope_restricted and truncated. Rate limits with one shared allowance are left out. Summaries are cached for up to 15 seconds.

## Response `200`

OK

- AiGatewayRateLimitInstancesSummaryListResponse: Response containing the counter summary of every template rate limit in the organization.
  - `data` AiGatewayRateLimitInstancesSummaryResource[], required
    - `attributes` AiGatewayRateLimitInstancesSummaryAttributes, required: Aggregate of a template rate limit's counters.
      - `instance_count` integer, required: Number of counters that were near or at a limit, or limited a request, in the last hour. Counters with room to spare aren't recorded.
      - `limited_requests` integer: Requests the counters rejected in the last 15 minutes (ENFORCE), totaled over the counters whose usage was read.
      - `limiting_count` integer, required: Counters that limited, or would have limited, a request in the last 15 minutes.
      - `max_utilization` number, double, required: Utilization of the fullest counter.
      - `near_limit_count` integer, required: Counters at 80% or more of a limit in the rolling window.
      - `rate_limit_id` string, uuid, required: Rate limit UUID.
      - `scope_restricted` boolean: True when the caller can't see the template's selector because it lists a provider or model the caller can't access. The counters are then hidden, and every count is zero.
      - `truncated` boolean, required: True when some recently active counters' usage wasn't read, so the counts may be low.
      - `would_limit_requests` integer: Requests the counters would have rejected in the last 15 minutes (ALERT), totaled over the counters whose usage was read.
    - `id` string, uuid, required: Rate limit UUID.
    - `type` 'rate-limit-instances-summary', required: AI Gateway rate limit counter summary resource type.

## Other responses

- `429`: Too many requests

## Changes

- **2026-11-13** `14d85160bfa9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/rate-limits/instances/summary/get.md)

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/14d85160bfa9?raw)
