# zip on GET /data/2.5/weather is deprecated

OpenWeather API deprecated GET /data/2.5/weather, query parameter zip without giving a shutdown date yet.

OpenWeather API has deprecated the zip query parameter on the GET /data/2.5/weather endpoint without a shutdown date. Affected calls will eventually fail, as requests by city name, zip-codes, and city id are being retired. Developers should update any requests relying on zip codes to avoid future disruptions.

## What to use instead

Resolve the ZIP code with the Geocoding API and call with lat and lon instead.

- API: OpenWeather API (api.openweathermap.org)
- Kind: Parameter removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /data/2.5/weather`, `query parameter zip`
- Source: [Announcement](https://openweathermap.org/api/current)
- Verified: November 6, 2026, against OpenWeather API's own pages
- Page: https://www.okapi.bot/providers/openweathermap/breaking-changes/zip-on-get-data-2-5-weather-is-deprecated/

## OpenWeather API's words

> Please note that API requests by city name, zip-codes and city id have been deprecated.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent