Security intelligence
for LATAM operations

{
  "ok": true,
  "data": {
    "estado": "Miranda",
    "municipio": null,
    "score": 58,
    "raw_score": 0,
    "level": "medium",
    "incidents_30d": 12,
    "beta": true,
    "scope": "estado",
    "source": "Centinela",
    "updated_at": "2026-10-19T08:11:08.741Z",
    "next_update": "2026-10-19T14:11:08.741Z"
  },
  "meta": {
    "plan": "basic",
    "source": "Centinela Risk API v1",
    "docs": "https://appcentinela.com/api"
  }
}

{
  "state": "miranda",
  "location": "Miranda",
  "year": 2023,
  "population_estimate": {
    "value": 2650669,
    "year": 2023
  },
  "metrics": {
    "tasa_homicidios_100k": {
      "value": 10.5,
      "year": 2023,
      "label": "Tasa de homicidios",
      "unit": "por 100.000 habitantes"
    },
    "tasa_muertes_violentas_100k": {
      "value": 41,
      "year": 2023,
      "label": "Tasa de muertes violentas",
      "unit": "por 100.000 habitantes"
    },
    "tasa_muertes_intervencion_policial_100k": {
      "value": 8.6,
      "year": 2023,
      "label": "Tasa de muertes por intervención policial",
      "unit": "por 100.000 habitantes"
    }
  },
  "national": {
    "tasa_homicidios_100k": {
      "value": 7.5,
      "year": 2023
    },
    "tasa_muertes_violentas_100k": {
      "value": 26.8,
      "year": 2023
    },
    "tasa_muertes_intervencion_policial_100k": {
      "value": 3.7,
      "year": 2023
    }
  },
  "overall_score": 80.5,
  "level": "crítico",
  "overall_score_basis": {
    "metric": "tasa_muertes_violentas_100k",
    "value": 41,
    "year": 2023
  },
  "overall_score_method": "Tramos fijos sobre la tasa de muertes violentas 2023 por 100.000 hab.: <5 bajo (0–20), 5–10 moderado (20–40), 10–20 alto (40–60), 20–40 muy alto (60–80), >40 crítico (80–100), interpolación lineal (METHODOLOGY.md)",
  "risks": null,
  "sources": [
    {
      "name": "Observatorio Venezolano de Violencia (OVV) · Mapa interactivo de la violencia 2023",
      "year": 2023,
      "url": "https://observatoriodeviolencia.org.ve/mapas-de-indicadores-de-violencia/mapa-interactivo-de-la-violencia-2023/",
      "license": "© Observatorio Venezolano de Violencia, todos los derechos reservados; se usan solo cifras agregadas, con atribución"
    }
  ],
  "source": "Observatorio Venezolano de Violencia (OVV) · Mapa interactivo de la violencia 2023 (2023)",
  "data_source": "informes_publicos",
  "beta": true,
  "provided_by": "Centinela Security Risk API"
}

{
  "ok": true,
  "h3": "8867412467fffff",
  "cell_center": {
    "lat": 10.496139,
    "lng": -66.854344
  },
  "distance_m": 268,
  "layers": {
    "seismic": {
      "score": 7,
      "level": "alto",
      "raw": {
        "score_catalog": 6,
        "mmax": 7.5,
        "count_historic": 1,
        "count_recent": 7,
        "municipio": {
          "estado": "Miranda",
          "nombre": "Chacao",
          "pcode": "VE1507"
        },
        "mmax_place": "20 km W of Catia La Mar, Venezuela",
        "covenin_zona": 5,
        "count_weighted": 7.5,
        "mmax_time": "2026-06-24T22:05:04.053Z",
        "capped_single_event": true
      },
      "explanation": "Sismicidad histórica alta (7/10): 7 sismos desde 1970 y 1 anterior (desde 1900) (sin contar réplicas) en su radio de influencia; el mayor, M7,5 (2026, 20 km al O de Catia La Mar, Venezuela). Score limitado: un sismo grande con poca actividad más alrededor no basta para subirlo más. Zona sísmica COVENIN 1756: 5 (A0 = 0,30 g)."
    },
    "flood": {
      "score": 1,
      "level": null,
      "raw": {
        "points_valid": 7,
        "aqueduct_coast_rp100_m": 0,
        "neighborhood_1km": 0,
        "index": 0,
        "max_depth_rp100_m": 0,
        "cell_hazard": 0,
        "aqueduct_river_rp100_m": 0,
        "method_version": 2,
        "frac_rp100": 0,
        "points_total": 7,
        "spurious_area": false,
        "frac_rp10": 0
      },
      "explanation": "Inundación: Sin llanura fluvial o costera modelada; no incluye inundación por lluvia. Ni GloFAS ni Aqueduct prevén desbordamiento de ríos ni marejada a menos de 1 km en una crecida de 100 años.",
      "coverage": "sin_llanura_modelada",
      "note": "Sin llanura fluvial o costera modelada; no incluye inundación por lluvia.",
      "notice": "GloFAS y Aqueduct modelan el desbordamiento de ríos y las marejadas; no modelan el anegamiento urbano por lluvia intensa ni las crecidas de quebradas pequeñas."
    },
    "fire": {
      "score": 1,
      "level": "bajo",
      "raw": {
        "urban_radius_km": 1,
        "density_5km": 0.03,
        "urban_fraction": 1,
        "pop_density_km2": 16971,
        "method_version": 2,
        "density_1km": 0,
        "radius_km": 5,
        "density_km2_year": 0,
        "years": "2012-2025"
      },
      "explanation": "Riesgo de incendios de vegetación bajo (1/10): zona urbana sin focos a menos de 1 km (2012–2025, satélite VIIRS, sin fuentes fijas como mechurrios); a menos de 5 km, 0,03 focos por km² al año."
    },
    "security": {
      "score": null,
      "overall_score": 80.5,
      "level": "crítico",
      "granularity": "estado",
      "estado": "Miranda",
      "level_scale": "Tramos de /v1/security sobre la tasa de muertes violentas 2023: <5 bajo, 5–10 moderado, 10–20 alto, 20–40 muy alto, >40 crítico",
      "tasa_muertes_violentas_100k": {
        "value": 41,
        "year": 2023
      },
      "explanation": "Seguridad a nivel de estado (Miranda): tasa de muertes violentas de 41 por 100.000 habitantes en 2023 según el OVV (crítico). No hay incidentes suficientes en la celda ni en el municipio.",
      "source": "Observatorio Venezolano de Violencia (OVV) · Mapa interactivo de la violencia 2023",
      "source_url": "https://observatoriodeviolencia.org.ve/mapas-de-indicadores-de-violencia/mapa-interactivo-de-la-violencia-2023/",
      "license": "© Observatorio Venezolano de Violencia, todos los derechos reservados; se usan solo cifras agregadas, con atribución",
      "year": 2023
    }
  },
  "attribution": "Sismicidad: U.S. Geological Survey, ANSS Comprehensive Earthquake Catalog (ComCat). Población: Kontur Population, CC BY 4.0. Zonificación: Norma COVENIN 1756-1:2001, Tabla 4.2 (FUNVISIS). Límites municipales: COD-AB Venezuela (INE, OCHA), CC BY-IGO. Líneas de vías y ríos: © OpenStreetMap contributors, ODbL. Inundación: Copernicus Emergency Management Service, GloFAS flood hazard maps (Baugh et al., 2024, JRC), CC BY 4.0; modificado (agregado por celda H3). Inundación (segunda fuente): WRI Aqueduct Floods v2, crecida de 100 años fluvial (WATCH 1980) y costera (sin subsidencia), CC BY 4.0. Incendios: NASA FIRMS (VIIRS S-NPP 375 m, 2012–2025). We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS).",
  "meta": {
    "plan": "basic",
    "version": 6,
    "built_at": "2026-10-19T01:43:39Z",
    "methodology": "Umbrales fijos; ver METHODOLOGY.md",
    "lookup": "h3",
    "docs_read": 2,
    "level_scale": "1–3 bajo · 4–5 moderado · 6–7 alto · 8–10 muy alto"
  }
}

curl -X POST https://registerwebhook-f6mmcvp3ia-uc.a.run.app/v1/webhooks \
  -H "x-api-key: cnt_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/centinela-webhook",
    "states": ["miranda", "monagas", "anzóategui"],
    "threshold": 15
  }'

{
  "state": "miranda",
  "location": "Miranda, Venezuela",
  "overall_score": 7,
  "overall_level": "severe",
  "risks": {
    "flood":     { "score": 8, "level": "severe",   "trend": "rising",  "label": "Inundación" },
    "fire":      { "score": 2, "level": "low",      "trend": "stable",  "label": "Incendio forestal" },
    "landslide": { "score": 6, "level": "moderate", "trend": "stable",  "label": "Deslizamiento" },
    "drought":   { "score": 4, "level": "moderate", "trend": "falling", "label": "Sequía" }
  },
  "horizon_years": 30,
  "last_updated": "2026-06-08T00:00:00Z",
  "source": "Centinela",
  "provided_by": "Centinela Climate Risk API"
}