List AI Gateway budget defaults

APIs & SDKs

GEThttps://api.vercel.com/ai-gateway/budgets/defaults/list

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.

https://api.vercel.com/ai-gateway/budgets/defaults/list

const response = await fetch('https://api.vercel.com/ai-gateway/budgets/defaults/list?teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "defaults": [
    {
      "active": "false",
      "alertThresholds": [],
      "createdAt": "123",
      "limitAmount": "123",
      "refreshPeriod": "daily",
      "scopeType": "api-key",
      "updatedAt": "123"
    }
  ]
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

teamIdstringOptional

The Team identifier to perform the request on behalf of.

slugstringOptional

The Team slug to perform the request on behalf of.

Response

200Success

defaultsarrayRequired

Errors

400Error

401The request is not authorized.

403You do not have permission to access this resource.

404Error

410Error

500Error

Cross-link map: List AI Gateway budget defaults (/docs/rest-api/ai-gateway/list-ai-gateway-budget-defaults)

From the Vercel docs graph (built 2026-10-10T05:32:43.016Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

List AI Gateway budgets — GET /ai-gateway/budgets/list — List the team's AI Gateway budgets \(team/project/user scopes, plus default-covered api-k
Upsert AI Gateway budget default — PUT /ai-gateway/budgets/defaults — Create or update an AI Gateway budget default for one scope. Team-level authority onl
Archive AI Gateway budget default — DELETE /ai-gateway/budgets/defaults — Delete an AI Gateway budget default for one scope. Team-level authority only \(own
Archive AI Gateway budget — DELETE /ai-gateway/budgets — Archive a team-, project-, or user-scope AI Gateway budget.
Upsert AI Gateway budget — PUT /ai-gateway/budgets — Create or update a team-, project-, or user-scope AI Gateway budget.

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/ai-gateway/budgets/defaults/list

const response = await fetch('https://api.vercel.com/ai-gateway/budgets/defaults/list?teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "defaults": [
    {
      "active": "false",
      "alertThresholds": [],
      "createdAt": "123",
      "limitAmount": "123",
      "refreshPeriod": "daily",
      "scopeType": "api-key",
      "updatedAt": "123"
    }
  ]
}

OpenAPI Specification