> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SIATA

> Live weather, rainfall, and air-quality station readings for the Aburrá Valley (Medellín).

Queries SIATA (Sistema de Alerta Temprana de Medellín y el Valle de Aburrá) for
the current readings of every monitoring station in the Aburrá Valley: weather
(temperature, humidity, wind, pressure), rainfall (accumulated and intensity),
and air quality (24-hour PM2.5 and ICA index).

`POST /co/siata/v1`

| Field       | Type   | Notes                                                             |
| ----------- | ------ | ----------------------------------------------------------------- |
| `latitude`  | number | Optional. -90 to 90. Must be sent together with `longitude`.      |
| `longitude` | number | Optional. -180 to 180. Must be sent together with `latitude`.     |
| `radius_km` | number | Optional. Radius in km around the point, 0-100. Defaults to `10`. |

All fields are optional. An empty body returns every station in the valley;
`latitude` + `longitude` narrows the response to nearby stations, **sorted
nearest first** with `distance_km` populated on each station.

```bash theme={"dark"}
curl https://api.croma.run/co/siata/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 6.2442, "longitude": -75.5812, "radius_km": 5 }'
```

The response groups stations by kind:

```json theme={"dark"}
{
  "data": {
    "meteorology": [
      {
        "station": "AMVA",
        "station_code": "44",
        "latitude": 6.24248,
        "longitude": -75.5735,
        "temperature_c": 22.5,
        "humidity_pct": 74.1,
        "wind_speed_ms": 5.2,
        "wind_direction_deg": 201.6,
        "wind_direction_cardinal": "SSW",
        "pressure_hpa": 825.9,
        "updated_at": "2026-07-12T22:53:02.000Z",
        "distance_km": 0.822
      }
    ],
    "rain": [
      {
        "station": "Instituto Jorge Robledo",
        "station_code": "23",
        "latitude": 6.258272,
        "longitude": -75.581128,
        "accumulated_mm": 0,
        "intensity_mm_h": 0,
        "updated_at": "2026-07-12T22:52:00.000Z",
        "distance_km": 1.564
      }
    ],
    "air_quality": [
      {
        "station": "Torre Social",
        "station_code": "81",
        "municipality": "Barbosa",
        "latitude": 6.43696,
        "longitude": -75.330452,
        "pm25": 10,
        "air_quality_index": 42,
        "updated_at": "2026-07-12T22:00:00.000Z",
        "distance_km": 4.1
      }
    ]
  }
}
```

Individual readings are `null` when a station hasn't reported them. Air-quality
values are 24-hour averages; `updated_at` marks the end of the averaging
window. Without a location filter, `distance_km` is `null` on every station.

<Note>
  Coverage is the Medellín metropolitan area (Valle de Aburrá) only. Points
  outside the valley return empty arrays rather than an error.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>
