---
title: "Get an AI Gateway rate limit counter summary"
method: GET
path: "/api/v2/rate-limits/{id}/instances/summary"
tags: ["AI Gateway"]
---

# Get an AI Gateway rate limit counter summary

`GET /api/v2/rate-limits/{id}/instances/summary`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/rate-limits/{id}/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 a template rate limit's hot counters (those near or at a limit, or limiting, in the last hour), including how many there are, how many are near or at their limit, and the fullest counter's utilization. Use split_dim to aggregate only counters that match every given dimension value. When the caller can't see the template's selector, every count is zero and scope_restricted is true. Summaries are cached for up to 15 seconds. Returns 503 when counter usage can't be read.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `split_dim` string[]

## Response `200`

OK

- AiGatewayRateLimitInstancesSummaryResponse: Response containing the aggregate of a template rate limit's counters.
  - `data` AiGatewayRateLimitInstancesSummaryResource, required: Aggregate of a template rate limit's counters.
    - `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

- `400`: Bad Request
- `404`: Not Found
- `429`: Too many requests

## Changes

- **2026-11-13** `6d6d61de83e2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/rate-limits/:id/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)
