Skip to content
Docs

AI Gateway Uptime and Provider Status

When a provider has an outage, AI Gateway falls back to a healthy provider so your requests still go through. The model detail page surfaces this in two views, Uptime and Status, both calculated from live AI Gateway traffic.

Both views share the same time-range toggle in the top-right corner. Each window uses a different bucket size:

ToggleWindowBucket size
1H1 hourPer-minute
1D1 day15-minute
1W1 weekPer-hour

The uptime view charts the percentage of successful requests over time, with one line for AI Gateway and one line for each upstream provider. Use it to compare providers, watch trends, and measure how much fallback is helping.

1-week uptime for anthropic/claude-opus-5
1-week uptime for anthropic/claude-opus-5

If a provider has no recent activity, AI Gateway can't measure its uptime, so the chart shows it at 100%. The 100% line is a placeholder, not a trend. It doesn't mean the provider was fully available.

You can open the uptime view from:

You can also link directly at vercel.com/ai-gateway/models/<model-id>#uptime, replacing <model-id> with the model you want to inspect. For example, see uptime for Claude Opus 4.7.

You can query uptime programmatically through the model endpoints API. Each endpoint in the response exposes three rolling uptime windows:

FieldWindow
uptime_last_15mLast 15 minutes
uptime_last_1hLast 1 hour
uptime_last_1dLast 1 day
curl -i https://ai-gateway.vercel.sh/v1/models/anthropic/claude-opus-5/endpoints \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY"

Replace anthropic/claude-opus-5 with the model ID you want to inspect, and set AI_GATEWAY_API_KEY to a valid AI Gateway API key.

The response returns one entry per provider serving the model, each with the three uptime windows:

{
  "data": {
    "id": "anthropic/claude-opus-5",
    "endpoints": [
      {
        "provider_name": "anthropic",
        "uptime_last_15m": 100,
        "uptime_last_1h": 99.8,
        "uptime_last_1d": 99.6
      },
      {
        "provider_name": "bedrock",
        "uptime_last_15m": 100,
        "uptime_last_1h": 100,
        "uptime_last_1d": 99.9
      },
      {
        "provider_name": "vertex",
        "uptime_last_15m": 100,
        "uptime_last_1h": 100,
        "uptime_last_1d": 99.1
      }
    ]
  }
}

The status view shows a row of health bars across the selected window, giving you a glanceable read on whether a provider is healthy. Each bar covers one time bucket. The color shows the success rate in that bucket:

ColorRangeMeaning
Green95% to 100%Healthy
Amber75% to less than 95%Degraded
RedLess than 75%Down

If a provider has no activity in a bucket, the bar reads "No activity" instead of a color.

1-day status for anthropic/claude-opus-5
1-day status for anthropic/claude-opus-5

You can open the status view from:

You can also link directly at vercel.com/ai-gateway/models/<model-id>#status, replacing <model-id> with the model you want to inspect. For example, see status for Claude Opus 4.7.

Select Share in the top-right corner of either view to export the current view as an image. The export captures the selected model, view, and time range so you can share a snapshot in tickets, postmortems, or status updates.

Example share output for the Uptime view (1-week range)
Example share output for the Uptime view (1-week range)
Example share output for the Status view
Example share output for the Status view

Bring Your Own Key (BYOK) requests aren't included, since their success depends on your own provider credentials rather than AI Gateway's.

These numbers reflect what AI Gateway observes, not a provider's overall availability. They may differ from a provider's own reported uptime due to factors specific to AI Gateway, like account tiering, regions, or routing decisions.

A provider attempt counts as successful when the provider returns a valid response. Uptime is calculated as:

uptime % = (successes / total) × 100

The following are excluded from the calculation entirely:

  • 4xx responses, since they don't reflect provider uptime issues. Receiving a 4xx means the provider was reachable and responded.
  • Requests using the only filter, for AI Gateway uptime only. The only filter restricts routing to a subset of providers, which limits how AI Gateway can fall back. These requests still count toward provider uptime.

AI Gateway reports two uptime metrics, which differ in what they count as successes and totals:

  • Provider uptime reflects the success rate of every individual attempt to a given provider.
  • AI Gateway uptime only considers the final attempt in each request, capturing the end-to-end outcome after any fallbacks.
MetricSuccessesTotal
Provider uptimeProvider's successful attemptsProvider's total attempts
AI Gateway uptimeSuccessful final attemptsTotal requests

A request that fails on its first provider but succeeds on a fallback counts as a success for AI Gateway uptime. This is why AI Gateway uptime can be higher than any individual provider's uptime, since fallback logic can recover from single-provider failures.

Last updated September 8, 2026

Was this helpful?

supported.