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

# SIATA Rainfall

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

## Request

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

Rain at every SIATA gauge in the Aburrá Valley (Medellín metropolitan area): whether it is raining now and the source's extreme-rain flag, rain accumulated over seven trailing windows (5 minutes to 30 days), and monthly totals for the current year with each month's data availability. All inputs optional: an empty body returns every gauge; pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby gauges 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

- SiataGeoportalRainfallResponse
  - `data` SiataGeoportalRainfallData, 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.
      - `comuna` string, nullable, required
      - `village` string, nullable, required
      - `district` string, nullable, required
      - `sub_basin` string, nullable, required
      - `is_raining` boolean, nullable, required: Whether the gauge is registering rain right now.
      - `extreme_rain` boolean, nullable, required: Whether the source flags the current rain as extreme.
      - `extreme_category` string, nullable, required: The source's category for extreme rain, when flagged.
      - `accumulated_mm` object, required
        - `last_5m` number, nullable, required
        - `last_30m` number, nullable, required
        - `last_1h` number, nullable, required
        - `last_3h` number, nullable, required
        - `last_24h` number, nullable, required
        - `last_72h` number, nullable, required
        - `last_30d` number, nullable, required
      - `monthly` object[], required
        - `month` string, required: `YYYY-MM`.
        - `total_mm` number, nullable, required
        - `data_availability_pct` number, nullable, required: Share of the month the gauge reported, in percent.
    - `advisories` string[], 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)