Skip to main content
    Developer docs

    Floodi Public APIs

    Floodi exposes live Florida flood data as GeoJSON and CAP v1.2 feeds. Free for government, research, and partner integrations. The GeoJSON endpoint is designed to drop directly into ArcGIS Online and WebEOC as a community flood intelligence layer.

    Data tiers: Every response includes a data_tier field — official (NWS-confirmed), verified (3+ community confirmations), or community (single unverified report). Always weight accordingly.

    Who this is for: Florida county GIS and emergency management teams, newsrooms and meteorologists, insurance and risk analysts, infrastructure and research partners, and property operators integrating flood awareness into their own tools. The public feed below is free and live — pick the path that matches your volume and use case.

    Access paths

    Start with the free public feed. Move up only when your volume or use case needs it — every path is scoped and honest about what exists today.

    Public feed

    Free · live now

    Live Florida flood reports and USGS/NWS readings as GeoJSON and CAP v1.2. No API key, CORS-open, ~15-minute refresh. Attribution required.

    For: Government GIS, newsrooms, researchers, civic developers.

    Pilot / scoped access

    On request

    Public-safe report filters (city, county, severity, date, verified status), higher-volume coordination, and ArcGIS / WebEOC integration support. Provided to approved partner pilots, not as open private API access.

    For: HOAs, property operators, and agencies running an integration pilot.

    Commercial license

    Custom

    Negotiated terms for high-volume or commercial use beyond the public feed's fair-use and attribution terms. No standard published price — scoped to your use case.

    For: InsurTech, reinsurance, risk analytics, infrastructure, real-estate data.

    Government evaluation

    Pilot-based

    Evaluate Floodi data feeds inside your existing operating picture as a supplemental layer, with an MOU or data-sharing agreement. No cost for the pilot period.

    For: County / municipal emergency management, public works, transportation.

    Public endpoint reference

    Free, no API key required. Fair-use caching expected; attribution required.

    GET
    Public

    https://floodi.app/api/floods.geojson

    GeoJSON FeatureCollection of active Florida flood reports. Suitable for ArcGIS Online, Leaflet, Mapbox, and WebEOC GIS layers.

    Query parameters

    bboxstring— Bounding box filter: minLng,minLat,maxLng,maxLate.g. -80.5,25.5,-80.0,26.0
    countystring— Filter by county name (partial match)e.g. Miami-Dade
    tierstring— Data tier: official | verified | community | all (default: all)e.g. official
    limitnumber— Max features (default: 1000, max: 5000)e.g. 500
    formatstring— geojson (default) or cap (CAP v1.2 Atom/XML)e.g. geojson
    {
      "type": "FeatureCollection",
      "generated_at": "2026-06-09T14:00:00Z",
      "count": 12,
      "features": [{
        "type": "Feature",
        "geometry": { "type": "Point", "coordinates": [-80.19, 25.77] },
        "properties": {
          "id": "uuid",
          "severity": "full",
          "status": "active",
          "data_tier": "official",       // official | verified | community
          "nws_confirmed": true,
          "county": "Miami-Dade",
          "confirmations": 5,
          "created_at": "2026-06-09T13:45:00Z",
          "url": "https://floodi.app/?report=uuid"
        }
      }]
    }
    GET
    Public

    https://floodi.app/api/floods.geojson?format=cap

    CAP v1.2 Atom feed of active flood reports. Compatible with WebEOC CAP consumers and IPAWS display systems. Disclaimer: Floodi is NOT an authorized IPAWS alert originator — this feed is for situational awareness only.

    <?xml version="1.0" encoding="UTF-8"?>
    <!-- DISCLAIMER: Community-sourced. NOT an authorized IPAWS alert originator. -->
    <feed xmlns="http://www.w3.org/2005/Atom">
      <title>Floodi Florida Flood Reports (CAP v1.2)</title>
      <alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
        <identifier>floodi-{uuid}</identifier>
        <status>Actual</status>
        <scope>Public</scope>
        <info>
          <event>Flood Report</event>
          <urgency>Expected</urgency>
          <severity>Severe</severity>
          <certainty>Observed</certainty>
        </info>
      </alert>
    </feed>
    GET
    Public

    https://ovrzaieqbjxdjfkycttg.supabase.co/functions/v1/official-readings-api

    USGS stream gauge readings and NWS flood stage data for Florida monitoring stations.

    Query parameters

    countystring— Filter by countye.g. Broward
    statusstring— minor | moderate | major | action | floode.g. flood
    {
      "gauges": [{
        "site_no": "02288900",
        "name": "New River near Fort Lauderdale",
        "county": "Broward",
        "current_ft": 8.2,
        "flood_stage_ft": 7.0,
        "status": "minor",
        "updated_at": "2026-06-09T14:00:00Z"
      }]
    }

    ArcGIS Online integration

    Florida county GIS teams can add Floodi's community flood layer to ArcGIS Online as a live GeoJSON feed. The layer refreshes every 5 minutes and is styled by data tier and severity.

    # Adding Floodi to ArcGIS Online
    1. In ArcGIS Online Map Viewer, click Add → Add Layer from URL
    2. Paste the GeoJSON endpoint URL
    3. Select "GeoJSON" as the file type
    4. Style features by the "data_tier" or "severity" field
    5. Set auto-refresh to 5 minutes for live data
    
    # Recommended symbology
    data_tier = "official"   → Green circle (NWS-confirmed)
    data_tier = "verified"   → Blue circle (3+ confirmations)
    data_tier = "community"  → Yellow circle (unverified)
    
    severity = "danger"      → Red
    severity = "full"        → Orange
    severity = "partial"     → Yellow
    severity = "minor"       → Light blue

    WebEOC integration

    Floodi is not a replacement for WebEOC — it is a flood-intelligence feed that enhances your existing common operating picture. The CAP v1.2 Atom feed can be consumed by WebEOC boards with CAP import capability, and the GeoJSON feed can be overlaid via ArcGIS integration.

    Step 1: Configure a WebEOC CAP import board pointing to the CAP feed URL.

    Step 2: Map severity field to your board's priority field.

    Step 3: Filter on data_tier = "official" for highest-confidence events during active incidents.

    Step 4: Contact [email protected] for a WebEOC board configuration template and county-specific setup support.

    Disclaimer: Floodi is NOT an authorized IPAWS alert originator and this CAP feed is not a substitute for official FEMA/NWS alert distribution.

    Data tiers explained

    Every feature includes a data_tier field. Use it to filter by confidence level in operational contexts.

    • 🟢 official — NWS-confirmed or agency-verified
    • 🔵 verified — 3+ independent community confirmations
    • 🟡 community — Single unverified submission

    Usage terms

    Public endpoints are free. Attribution required: "Source: Floodi community flood reports (floodi.app)". High-volume commercial use requires a data license agreement.

    Request commercial license

    InsurTech / reinsurance

    Floodi community reports provide real-time Florida ground truth that can complement commercial flood models (e.g. Fathom, JBA, Floodbase) with street-level observations during active events.

    Data partnership inquiry

    Research access

    Academic institutions can request a research data use agreement for historical export. See our research partnerships page.

    Research partnerships →