United States Army Corps of Engineers

The U.S. Army Corps of Engineers (USACE) provides engineering and construction services for the nation, managing water resources, infrastructure, and environmental projects. USACE operates the Corps Water Management System (CWMS) Data API, a RESTful service for accessing real-time and historical water management data including time series measurements, location information, ratings, forecasts, and project data for USACE-managed water resources across the United States.

1 APIs 0 Features

EngineeringFederal GovernmentWater ResourcesHydrologyCivil Engineering

APIs

CWMS Data API

The Corps Water Management System (CWMS) Data API provides a RESTful interface for retrieving water management data from the U.S. Army Corps of Engineers. Supports access to tim...

Collections

CWMS Data API

OPEN

Pricing Plans

United States Army Corps Of Engineers Plans Pricing

3 plans

PLANS

Rate Limits

United States Army Corps Of Engineers Rate Limits

5 limits

RATE LIMITS

FinOps

United States Army Corps Of Engineers Finops

FINOPS

Semantic Vocabularies

United States Army Corps Of Engineers Context

4 classes · 24 properties

JSON-LD

API Governance Rules

United States Army Corps of Engineers API Rules

9 rules · 1 errors 7 warnings 1 info

SPECTRAL

JSON Structure

Cwms Data Api Location Structure

0 properties

JSON STRUCTURE

Cwms Data Api Timeseries Structure

0 properties

JSON STRUCTURE

Example Payloads

Cwms Data Api Getcatalog Example

2 fields

EXAMPLE

Cwms Data Api Getlocations Example

2 fields

EXAMPLE

Cwms Data Api Gettimeseries Example

2 fields

EXAMPLE

Resources

Sources

opencollection: 1.0.0
info:
  name: CWMS Data API
  version: 3.0.0
items:
- info:
    name: Version
    type: folder
  items:
  - info:
      name: Get API Root
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/
    docs: Returns a welcome message confirming the API is available.
  - info:
      name: Get API Version
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/version
    docs: Returns the current version of the CWMS Data API.
- info:
    name: Catalog
    type: folder
  items:
  - info:
      name: Get Catalog
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/catalog/:datastore-type
      params:
      - name: datastore-type
        value: ''
        type: path
        description: The type of data to catalog (TIMESERIES, LOCATIONS, RATINGS, etc.)
      - name: page
        value: ''
        type: query
        description: Pagination cursor from a previous response
      - name: page-size
        value: ''
        type: query
        description: Number of results to return per page (max 500)
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code (e.g., SWT, LRN)
      - name: like
        value: ''
        type: query
        description: Filter results using a CWMS wildcard pattern
    docs: Returns a catalog of available time series, locations, or other data stored in CWMS. Use this endpoint to discover
      available data.
- info:
    name: Locations
    type: folder
  items:
  - info:
      name: Get Locations
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/locations
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: names
        value: ''
        type: query
        description: Comma-separated list of location names (supports CWMS wildcards)
      - name: unit
        value: ''
        type: query
        description: Measurement unit system (EN for English, SI for metric)
      - name: datum
        value: ''
        type: query
        description: Vertical datum for elevation values (NAVD88, NGVD29, etc.)
      - name: format
        value: ''
        type: query
        description: Response format
    docs: Returns location data for USACE-managed sites including dams, reservoirs, stream gages, and other water resource
      facilities.
  - info:
      name: Create Location
      type: http
    http:
      method: POST
      url: https://cwms-data.usace.army.mil/cwms-data/locations
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Creates a new location record in CWMS. Requires authentication.
  - info:
      name: Get Location
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/locations/:location-id
      params:
      - name: location-id
        value: ''
        type: path
        description: The CWMS location identifier
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: unit
        value: ''
        type: query
        description: Measurement unit system (EN or SI)
    docs: Returns data for a specific USACE location.
  - info:
      name: Update Location
      type: http
    http:
      method: PATCH
      url: https://cwms-data.usace.army.mil/cwms-data/locations/:location-id
      params:
      - name: location-id
        value: ''
        type: path
        description: The CWMS location identifier
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Updates an existing location record. Requires authentication.
  - info:
      name: Delete Location
      type: http
    http:
      method: DELETE
      url: https://cwms-data.usace.army.mil/cwms-data/locations/:location-id
      params:
      - name: location-id
        value: ''
        type: path
        description: The CWMS location identifier
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Deletes a location record. Requires authentication.
- info:
    name: Time Series
    type: folder
  items:
  - info:
      name: Get Time Series
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/timeseries
      params:
      - name: name
        value: ''
        type: query
        description: The time series identifier in CWMS format (e.g., DALT2.Stage.Inst.15Minutes.0.raw)
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: unit
        value: ''
        type: query
        description: Measurement unit for the returned data
      - name: datum
        value: ''
        type: query
        description: Vertical datum for elevation values
      - name: begin
        value: ''
        type: query
        description: Start of time window in ISO 8601 format or milliseconds since epoch
      - name: end
        value: ''
        type: query
        description: End of time window in ISO 8601 format or milliseconds since epoch
      - name: timezone
        value: ''
        type: query
        description: Timezone for interpreting date/time values
      - name: format
        value: ''
        type: query
        description: Response format
      - name: page
        value: ''
        type: query
        description: Pagination cursor from a previous response
      - name: page-size
        value: ''
        type: query
        description: Number of time series values per page
    docs: Returns time series data for a specified time window. Time series data includes measurements such as river stage,
      flow, precipitation, temperature, and reservoir pool elevation over time.
  - info:
      name: Get Recent Time Series
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/timeseries/recent
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: name
        value: ''
        type: query
        description: Time series identifier (supports CWMS wildcards)
      - name: recently-changed-within
        value: ''
        type: query
        description: ISO 8601 duration for how recently the data was updated (e.g., PT2H for 2 hours)
    docs: Returns the most recent time series values. Useful for displaying current conditions at USACE locations.
  - info:
      name: Get Filtered Time Series
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/timeseries/filtered
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: name
        value: ''
        type: query
        description: Time series identifier (supports CWMS wildcards)
    docs: Returns filtered time series data based on specified criteria.
- info:
    name: Levels
    type: folder
  items:
  - info:
      name: Get Level Time Series
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/levels/:level-id/timeseries
      params:
      - name: level-id
        value: ''
        type: path
        description: The location level identifier
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: begin
        value: ''
        type: query
        description: Start of time window in ISO 8601 format
      - name: end
        value: ''
        type: query
        description: End of time window in ISO 8601 format
    docs: Returns time series for a specified location level.
  - info:
      name: Get Levels
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/levels
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: location-id
        value: ''
        type: query
        description: Location identifier (supports wildcards)
      - name: begin
        value: ''
        type: query
        description: Start of effective date range
      - name: end
        value: ''
        type: query
        description: End of effective date range
      - name: unit
        value: ''
        type: query
        description: Measurement unit system (EN or SI)
      - name: datum
        value: ''
        type: query
        description: Vertical datum for elevation values
      - name: page
        value: ''
        type: query
        description: Pagination cursor
      - name: page-size
        value: ''
        type: query
        description: Number of results per page
    docs: Returns location levels (flood stage, normal pool, etc.) for USACE locations.
- info:
    name: Ratings
    type: folder
  items:
  - info:
      name: Get Ratings
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/ratings
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: rating-id
        value: ''
        type: query
        description: Rating identifier (supports CWMS wildcards)
      - name: start
        value: ''
        type: query
        description: Start of effective date range
      - name: end
        value: ''
        type: query
        description: End of effective date range
      - name: timezone
        value: ''
        type: query
        description: Timezone for date/time values
      - name: format
        value: ''
        type: query
        description: Response format
    docs: Returns rating tables used to convert between measured values (e.g., stage to flow, gate opening to discharge).
- info:
    name: Basins
    type: folder
  items:
  - info:
      name: Get Basins
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/basins
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: basin-id
        value: ''
        type: query
        description: Basin identifier (supports wildcards)
      - name: unit
        value: ''
        type: query
        description: Measurement unit system (EN or SI)
      - name: page
        value: ''
        type: query
        description: Pagination cursor
      - name: page-size
        value: ''
        type: query
        description: Number of results per page
    docs: Returns river basin information for USACE water management areas.
- info:
    name: Forecasts
    type: folder
  items:
  - info:
      name: Get Forecast Specifications
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/forecast-spec
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: spec-id-mask
        value: ''
        type: query
        description: Mask for filtering forecast spec IDs (supports wildcards)
      - name: designator-mask
        value: ''
        type: query
        description: Mask for filtering designators
      - name: location-mask
        value: ''
        type: query
        description: Mask for filtering locations
    docs: Returns forecast specifications available in the CWMS system.
  - info:
      name: Get Forecast Instances
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/forecast-instance
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: name
        value: ''
        type: query
        description: Forecast spec name
      - name: designator
        value: ''
        type: query
        description: Forecast designator
      - name: forecast-date
        value: ''
        type: query
        description: Forecast issue date in ISO 8601 format
      - name: issue-date
        value: ''
        type: query
        description: Date forecast was issued in ISO 8601 format
    docs: Returns forecast instances with time series data.
- info:
    name: Projects
    type: folder
  items:
  - info:
      name: Get Projects
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/projects
      params:
      - name: office
        value: ''
        type: query
        description: Three-character USACE district office code
      - name: id-mask
        value: ''
        type: query
        description: Project ID mask (supports wildcards)
      - name: page
        value: ''
        type: query
        description: Pagination cursor
      - name: page-size
        value: ''
        type: query
        description: Number of results per page
    docs: Returns USACE water resource projects (dams, locks, reservoirs).
- info:
    name: Parameters
    type: folder
  items:
  - info:
      name: Get Parameters
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/parameters
    docs: Returns the list of physical parameters available in the CWMS system (e.g., Stage, Flow, Precip, Temp).
  - info:
      name: Get Units
      type: http
    http:
      method: GET
      url: https://cwms-data.usace.army.mil/cwms-data/units
      params:
      - name: format
        value: ''
        type: query
        description: Response format
    docs: Returns the list of measurement units available in the CWMS system.
bundled: true