Language selection

Government of Canada / Gouvernement du Canada

Search

Web Service

General Information
  • A user is expected to write a script to request data.
  • Response Codes:
    • 405 Method Not Allowed if the incorrect method is used
    • 422 Unprocessable Entity if the required parameters are missing or the values are formatted incorrectly
  • If there is no data available for the stations/parameters/time period specified, the script will return an empty file (with only the column headers).
  • All times are in UTC, unless otherwise noted below.
Real-Time Data
Real-Time Data

Technical Information

  • URL:
    https://wateroffice.ec.gc.ca/services/real_time_data/csv/inline?stations[]=&parameters[]=&start_date=&end_date=
  • Request Method: GET
  • Parameters:
    • stations[]
      • Multiple stations can be requested,
        e.g. stations[]=07EA004&stations[]=07EA005
    • parameters[]
      • See available parameters below.
      • Multiple parameters can be requested,
        e.g. parameters[]=46&parameters[]=47
    • start_date
      • In the format YYYY-MM-DD HH24:MI:SS,
        e.g. 2025-11-09 04:52:54
    • end_date
      • In the format YYYY-MM-DD HH24:MI:SS,
        e.g. 2025-11-09 04:52:54
  • File Format:
    • CSV
  • Notes:
    • If you require a large amount of data, it may be necessary to split the request into multiple requests with either a reduced amount of stations or a reduced time period.
    • If you only require the most recent data available (the latest 5 minutes), please use "Recent Real-Time Data" below.
List of Parameters
Parameter ID Parameter Name
3 Water level (daily mean values)
6 Discharge (daily mean values)
46 Water level (unit values)
47 Discharge (unit values)

Request Parameters

File Format (required)

Dates

All times are in UTC.

Link

 
Recent Real-Time Data

Technical Information

  • URL:
    https://wateroffice.ec.gc.ca/services/recent_real_time_data/csv/inline?stations[]=&parameters[]=
  • Request Method: GET
  • Parameters:
    • stations[]
      • Multiple stations can be requested,
        e.g. stations[]=07EA004&stations[]=07EA005
      • If this is omitted, all stations will be returned.
    • parameters[]
      • Only parameters 46 and 47 are available.
      • Multiple parameters can be requested,
        e.g. parameters[]=46&parameters[]=47
  • File Format:
    • CSV

Request Parameters

File Format (required)

Stations

Parameters (required)

Link

 
Current Conditions

Technical Information

  • URL:
    https://wateroffice.ec.gc.ca/services/current_conditions/xml/inline?stations[]=&lang=
  • Request Method: GET
  • Parameters:
    • stations[]
      • Multiple stations can be requested,
        e.g. stations[]=07EA004&stations[]=07EA005
      • If this is omitted, all stations will be returned.
    • lang
      • en or fr
  • File Format:
    • KML

Request Parameters

File Format (required)

Stations

Link

- GET
 
Historical Data
Daily Mean

Technical Information

  • URL:
    https://wateroffice.ec.gc.ca/services/daily_data/csv/inline?stations[]=&parameters[]=&start_date=&end_date=
  • Request Method: GET
  • Parameters:
    • stations[]
      • Multiple stations can be requested,
        e.g. stations[]=07EA004&stations[]=07EA005
    • parameters[]
      • level or flow
      • Multiple parameters can be requested,
        e.g. parameters[]=level&parameters[]=flow
    • start_date
      • In the format YYYY-MM-DD,
        e.g. 2025-11-09
      • All times are in Local Standard Time (LST)
    • end_date
      • In the format YYYY-MM-DD,
        e.g. 2025-11-09
      • All times are in Local Standard Time (LST)
  • File Format:
    • CSV
  • Notes:
    • If you require a large amount of data, it may be necessary to split the request into multiple requests with either a reduced amount of stations or a reduced time period.

Request Parameters

File Format (required)

Parameters (required)

Dates

All times are in Local Standard Time (LST)

Link

- GET
 
Statistics
Daily Mean

Technical Information

  • URL:
    https://wateroffice.ec.gc.ca/services/daily_stats/csv/inline?stations[]=
  • Request Method: GET
  • Parameters:
    • stations[]
      • Multiple stations can be requested,
        e.g. stations[]=07EA004&stations[]=07EA005
    • start_date
      • mmdd
        • e.g. 0101 for January 1
    • end_date
      • mmdd
        • e.g. 1231 for December 31
  • File Format:
    • CSV

Request Parameters

File Format (required)

Link

- GET
 

What we are doing

Real-time Data

Historical Data

Resources

Page details

Feedback about this web site
Date modified: