---
title: "List active API deprecations."
method: GET
path: "/.well-known/deprecations"
tags: ["Meta"]
---

# List active API deprecations.

`GET /.well-known/deprecations`

## Request

- Base URL: `https://api.smarterweather.com`
- URL: `https://api.smarterweather.com/.well-known/deprecations`
- Auth: none required

Returns the current set of active deprecations as required by the
public-contract policy summarised in this document's Versioning and
deprecation section. Empty list when no deprecations are active.

## Response `200`

Current deprecations (possibly empty).

- object
  - `deprecations` Deprecation[], required: Active deprecations.
    - `surface` string, required: The deprecated surface, expressed as a stable identifier. Common forms include an operation path (`/v1/weather`), a parameter reference (`/v1/weather?param=foo`), or a response-field JSON Pointer (`/v1/weather#/current/feels_like`).
    - `announced_at` string, date, required: ISO 8601 date on which the deprecation was announced.
    - `sunset_at` string, date, required: ISO 8601 date on or after which the deprecated surface may be removed (minimum 90 days for shape changes, 6 months for endpoint removal).
    - `migration` string, required: Short prose pointer to the replacement surface or migration guide. Clients should treat this as documentation, not a machine-parseable URL.

---

[API](https://skmtc.dev/smarterweather/apis/smarter-weather-api.md) · [All operations](https://skmtc.dev/smarterweather/apis/smarter-weather-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smarterweather/apis/smarter-weather-api/revisions/520d55a696e4?raw)