---
title: "List AI Gateway budget defaults"
method: GET
path: "/ai-gateway/budgets/defaults/list"
tags: ["ai-gateway"]
---

# List AI Gateway budget defaults

`GET /ai-gateway/budgets/defaults/list`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/ai-gateway/budgets/defaults/list`
- Auth: HTTP bearer

List the team's AI Gateway budget defaults as a flat per-scope list (one row per team/project/api-key/user scope with a default set). An empty list is a normal state for the dashboard.

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

- AiGatewayBudgetDefaultList
  - `defaults` AiGatewayBudgetDefault[], required
    - `active` false | true, required
    - `alertThresholds` number[]
    - `createdAt` number, required
    - `limitAmount` number, required
    - `refreshPeriod` 'daily' | 'monthly' | 'none' | 'weekly', required
    - `scopeType` 'api-key' | 'project' | 'team' | 'user', required
    - `updatedAt` number, required

## Other responses

- `400`
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `500`

## Changes

- **2026-09-30** `6f68095b42b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/ai-gateway/budgets/defaults/list/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)