---
title: "Get weather by city"
method: GET
path: "/weather"
tags: ["Data AI — Weather"]
---

# Get weather by city

`GET /weather`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/weather`
- Auth: HTTP bearer

Returns current weather and forecast for a city name (geocoded server-side).

This operation has 2 documented variants (same method and path, different fields):
- [Get weather by city](https://api.paperoffice.ai/latest/docs/endpoints/po-weather-by-city.md) — Returns current weather and forecast for a city name (geocoded server-side).
- [Get weather by coordinates](https://api.paperoffice.ai/latest/docs/endpoints/po-weather-by-coordinates.md) — Returns current weather and a multi-day forecast for GPS coordinates.

## Query parameters

- `city` string
- `country` string
- `lang` string
- `locale` string
- `lat` number
- `lon` number

## Response `200`

Success

- SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints).
  - `status` 'success', required
  - `processing_time` union
    - string
    - number
  - `_billing` object

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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