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

# Model Deprecations

`GET /v1/model/deprecations`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/v1/model/deprecations`
- Auth: API key in header `x-litellm-api-key`

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 $LITELLM_MASTER_KEY"
```

## 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-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/v1/model/deprecations/get.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)