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

# SIATA Cameras

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

## Request

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

SIATA's camera network in the Aburrá Valley (Medellín metropolitan area), about 90 cameras pointed at river gauges, the sky, underpasses and the boundary layer, each with the URL of its latest snapshot. All inputs optional: pass `latitude` + `longitude` (with optional `radius_km`, default 10) for nearby cameras nearest first, or `type` (`nivel`, `cielo`, `deprimido`, `capa_limite`) to keep one kind.

## 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.
  - `type` string: Optional camera type: `nivel` (river gauges), `cielo` (sky), `deprimido` (underpasses) or `capa_limite` (boundary layer).

## Response `200`

Successful response

- SiataGeoportalCamerasResponse
  - `data` SiataGeoportalCamerasData, required
    - `cameras` object[], required
      - `camera_code` string, nullable, required
      - `camera` string, required
      - `short_name` string, nullable, required
      - `type` string, nullable, required: `nivel`, `cielo`, `deprimido` or `capa_limite`.
      - `type_label` string, nullable, required
      - `snapshot_url` string, nullable, required: The latest still from the camera; refreshed by the source about every minute.
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `distance_km` number, nullable, required: Great-circle distance in km from the query point; null when no location filter was applied.

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