---
title: "Model Deprecations"
method: GET
path: "/model/deprecations"
tags: ["model management"]
---

# Model Deprecations

`GET /model/deprecations`

List models with known deprecation/sunset dates, bucketed by urgency.

Reads `deprecation_date` metadata from `model_prices_and_context_window.json`
(and any per-deployment `model_info.deprecation_date` overrides) for the
models configured on this proxy.

Parameters:
    warn_within_days: Window (in days) used to bucket "imminent" models,
        30 by default.

Returns:
    A payload with three lists of `ModelDeprecationInfo` entries:

    - `deprecated`: deprecation date is in the past, so these requests may
      fail at any time.
    - `imminent`: deprecation date is within `warn_within_days` from today.
    - `upcoming`: deprecation date is further out.

Example:
```shell
curl -X GET 'http://localhost:4000/model/deprecations' \
    -H 'Authorization: Bearer sk-1234'
```

## Query parameters

- `warn_within_days` integer

## Response `200`

Successful Response

- ModelDeprecationResponse
  - `deprecated` ModelDeprecationInfo[] — Models whose deprecation date has already passed.
    - `model_name` string, required — The public name of the model on the proxy (model_group).
    - `litellm_model` string, nullable — The underlying litellm model string the deprecation date is sourced from.
    - `deprecation_date` string, date, required — The date (UTC) when the model becomes deprecated.
    - `days_until_deprecation` integer, required — Days remaining until the deprecation date. Negative if the model is already deprecated.
    - `status` 'upcoming' | 'imminent' | 'deprecated', required — 'deprecated' if the date has passed, 'imminent' if it falls within warn_within_days, 'upcoming' otherwise.
    - `litellm_provider` string, nullable — The provider this model belongs to.
  - `imminent` ModelDeprecationInfo[] — Models whose deprecation date is within warn_within_days from today and require immediate migration planning.
    - `model_name` string, required — The public name of the model on the proxy (model_group).
    - `litellm_model` string, nullable — The underlying litellm model string the deprecation date is sourced from.
    - `deprecation_date` string, date, required — The date (UTC) when the model becomes deprecated.
    - `days_until_deprecation` integer, required — Days remaining until the deprecation date. Negative if the model is already deprecated.
    - `status` 'upcoming' | 'imminent' | 'deprecated', required — 'deprecated' if the date has passed, 'imminent' if it falls within warn_within_days, 'upcoming' otherwise.
    - `litellm_provider` string, nullable — The provider this model belongs to.
  - `upcoming` ModelDeprecationInfo[] — Models with a future deprecation date outside the warn window.
    - `model_name` string, required — The public name of the model on the proxy (model_group).
    - `litellm_model` string, nullable — The underlying litellm model string the deprecation date is sourced from.
    - `deprecation_date` string, date, required — The date (UTC) when the model becomes deprecated.
    - `days_until_deprecation` integer, required — Days remaining until the deprecation date. Negative if the model is already deprecated.
    - `status` 'upcoming' | 'imminent' | 'deprecated', required — 'deprecated' if the date has passed, 'imminent' if it falls within warn_within_days, 'upcoming' otherwise.
    - `litellm_provider` string, nullable — The provider this model belongs to.
  - `warn_within_days` integer, required — The window (in days) used to bucket 'imminent' models.
  - `checked_at` string, date-time, required — UTC timestamp when the deprecation snapshot was generated.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/model/deprecations/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/731afbea6a1b?raw)