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

# SIATA Alerts

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

## Request

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

Official notices from SIATA, the early-warning system of the Aburrá Valley (Medellín metropolitan area): title, plain-text description, validity dates and audience. Returns the active notices; pass `include_past: true` for every notice on record, most recent first.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `include_past` boolean: When true, returns past notices as well as the active ones.

## Response `200`

Successful response

- SiataGeoportalAlertsResponse
  - `data` SiataGeoportalAlertsData, required
    - `alerts` object[], required
      - `id` number, required
      - `title` string, required
      - `description` string, nullable, required: The notice as plain text.
      - `start_date` string, nullable, required
      - `end_date` string, nullable, required
      - `is_active` boolean, required
      - `audience` string, nullable, required: Who the source addresses the notice to, e.g. `citizen`.

## 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)