---
title: "List Automatic Fallbacks"
method: GET
path: "/api/v1/organizations/me/automatic-fallbacks"
tags: ["routing"]
---

# List Automatic Fallbacks

`GET /api/v1/organizations/me/automatic-fallbacks`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Otari-Key`
  - API key in header `x-api-key`

The models the caller's organization sent requests to in the last 30 days, and the fallback each gets.

A request that sends a model's catalog ID moves to the model's next offering
when one fails, with no policy. Each model lists its offerings in the order
such a request tries them, priced for this organization, with who runs the
built-in tools on each, beside its traffic: how many requests a backup served,
and how many named one offering and so had no fallback. The traffic is the
workspaces the caller may see in their active organization, by the rule the
organization's usage reads use.

## Response `200`

Successful Response

- AutomaticFallbacksResponse: The automatic fallbacks the caller's organization used.
  - `models` AutomaticFallbackPublic[], required: Most requested first.
    - `fell_back` integer, required: Of `requests`, the successful ones a later offering served.
    - `id` string, required: The catalog ID a caller sends to get the fallback, e.g. `anthropic/claude-sonnet-5`.
    - `name` string, required
    - `offerings` FallbackOfferingPublic[], required: What a request sent by catalog ID tries, first first. One entry means no backup.
      - `otari_tools` string[], required: Built-in tools Otari runs in this provider's place, for that caller.
      - `own_tools` string[], required: Built-in tools this provider runs itself, for a caller that declares them in the provider's own words and leaves the choice of executor to the deployment.
      - `provider` string, required: The provider instance the selector names.
      - `provider_type` string, required: The any-llm implementation behind the instance.
      - `selector` string, required: The offering, in `instance:model` form.
    - `pinned` integer, required: Of `requests`, those that named an offering or a policy rather than the catalog ID, and so got no automatic fallback.
    - `pinned_provider` string, nullable, required: The instance most pinned requests reached.
    - `requests` integer, required: Requests served in the window, each counted once however many attempts.
  - `window_days` integer, required: How many days of traffic the counts cover.

## Changes

- **2026-10-15** `fc9e1bb9b19f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mozilla-ai/apis/otari/changes/api/v1/organizations/me/automatic-fallbacks/get.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/b7bdd49b4752?raw)
