---
title: "SIATA Weather"
method: POST
path: "/co/siata-geoportal/weather/v1"
tags: ["Colombia", "SIATA"]
---

# SIATA Weather

`POST /co/siata-geoportal/weather/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/siata-geoportal/weather/v1`
- Auth: HTTP bearer

Current weather at every SIATA station in the Aburrá Valley (Medellín metropolitan area): temperature, humidity, wind, pressure, an hourly 12-hour series per station, and the valley's UV index with today's hourly series. All inputs optional: an empty body returns every station; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby stations nearest first, or `municipality` / `station_code` to narrow. Coverage is the Medellín metro area only.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `latitude` number: Optional latitude. With `longitude`, returns only stations near that point.
  - `longitude` number: Optional longitude. With `latitude`, returns only stations near that point.
  - `radius_km` number: Radius in km around `latitude`/`longitude` to include stations. Defaults to 10.
  - `municipality` string: Optional municipality filter, e.g. `Medellín` or `Itagüí`. Accents and case are ignored.
  - `station_code` string: Optional station code, e.g. `520`. Returns only that station.

## Response `200`

Successful response

- SiataGeoportalWeatherResponse
  - `data` SiataGeoportalWeatherData, required
    - `stations` object[], required
      - `station_code` string, nullable, required
      - `station` string, required
      - `municipality` string, nullable, required
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `updated_at` string, nullable, required: ISO timestamp of the station's last update at the source.
      - `distance_km` number, nullable, required: Great-circle distance in km from the query point; null when no location filter was applied.
      - `temperature_c` number, nullable, required
      - `humidity_pct` number, nullable, required
      - `wind_speed_ms` number, nullable, required: Wind speed in m/s.
      - `wind_direction_deg` number, nullable, required
      - `wind_direction_cardinal` string, nullable, required
      - `pressure_hpa` number, nullable, required
      - `series_12h` object[], required: Hourly temperature and humidity over the last 12 hours, oldest first.
        - `at` string, required
        - `temperature_c` number, nullable, required
        - `humidity_pct` number, nullable, required
    - `uv` object, nullable, required: The valley's UV reading; null when the sensor has not reported.
      - `station_code` string, nullable, required
      - `station` string, required
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `index` number, nullable, required: UV index.
      - `category` string, nullable, required: The source's UV category, e.g. `Bajo`, `Moderado`, `Alto`.
      - `temperature_c` number, nullable, required
      - `measured_at` string, nullable, required
      - `series` object[], required: Hourly UV index today, oldest first.
        - `at` string, required
        - `index` number, nullable, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)