Sign up
All data sources

NOAA NWPS (River & Flood)

No authnoaa-nwps

NOAA National Water Prediction Service — official NWS river-stage observations & forecasts, flood-category thresholds, and National Water Model streamflow. Assess flood risk to pads, pipelines, crossings and facilities, and model water availability with map-ready gauge metadata. No auth.

Get this contract as JSON

Provenance

PublisherNOAA NWPS (River & Flood)
API basehttps://api.water.noaa.gov/nwps/v1

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (6)

  • searchGaugesByBbox

    read

    River gauges within a bounding box

    Input schema
    {
  "type": "object",
  "properties": {
    "xmin": {
      "type": "number",
      "examples": [
        -98
      ]
    },
    "ymin": {
      "type": "number",
      "examples": [
        29
      ]
    },
    "xmax": {
      "type": "number",
      "examples": [
        -94
      ]
    },
    "ymax": {
      "type": "number",
      "examples": [
        33
      ]
    },
    "srid": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

    Requires xmin/ymin/xmax/ymax; srid defaults to 4326 and is required upstream.

  • getGauge

    read

    Full gauge metadata + flood thresholds by NWS LID (NOAA NWPS (River & Flood)).

    Input schema
    {
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "examples": [
        "RMYT2"
      ]
    }
  },
  "additionalProperties": false
}

    Args: identifier (5-char NWS LID).

  • getGaugeStageFlow

    read

    Observed + forecast stage/flow time series for a gauge

    Input schema
    {
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "examples": [
        "RMYT2"
      ]
    }
  },
  "additionalProperties": false
}

    Args: identifier.

  • getGaugeRatings

    read

    Stage/discharge rating curve for a gauge

    Input schema
    {
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "examples": [
        "RMYT2"
      ]
    }
  },
  "additionalProperties": false
}

    Args: identifier.

  • getReachStreamflow

    read

    National Water Model streamflow forecast for a reach

    Input schema
    {
  "type": "object",
  "properties": {
    "reachId": {
      "type": "string",
      "examples": [
        "1513293"
      ]
    },
    "series": {
      "type": "string",
      "examples": [
        "short_range"
      ]
    }
  },
  "additionalProperties": false
}

    reachId required; series supports short, medium, long, blend, or assimilation.

  • getServiceInfo

    read

    Static API overview — srid=4326 bbox requirement, LID vs reachId, flood-risk value

    Input schema
    {
  "type": "object",
  "properties": {},
  "additionalProperties": false
}