Developers
Mesonet API
  • Getting Started
  • Reference
  • Explorer
  • Examples
  • Pricing
  • Precipitation Service

    Mesonet API Services

    Returns derived precipitation for a station or set of stations based on a time span

    Request Format

    A Precipitation request is an HTTP URL with the following form:

    https://api.synopticdata.com/v2/stations/precip
    

    Acquiring data from this web service requires certain parameters. When encoding URLs, all parameters are separated using the ampersand (&) character and their value is indicated by an equal sign (=). Below is a list of accepted parameters.

    All times are requested in UTC, but may be returned in either UTC or Local time format for each station. See the obtimezone parameter.

    Optional Parameters

    The following example requests precipitation from from stid=wbb for all of January 2017 in terms of day intervals.

    https://api.synopticdata.com/v2/stations/precip?stid=wbb&start=201701010000&end=201701312359&pmode=intervals&interval=day&token=YOUR_TOKEN_HERE
    

    Response Format Parameters

    Request Response

    JSON Format

    The Precipitation service will return its results in a single organized and self describing JSON object. At a minimum, every request will return a JSON object with a "SUMMARY" field.

    An example JSON response would be:

    {
      "UNITS": {
        "precipitation": "Millimeters"
      },
      "STATION": [
        {
          "STATUS": "ACTIVE",
          "MNET_ID": "153",
          "PERIOD_OF_RECORD": {
            "start": "1997-01-01T00:00:00Z",
            "end": "2018-01-10T12:00:00Z"
          },
          "ELEVATION": "4806",
          "NAME": "U of U William Browning Building",
          "RESTRICTED": false,
          "STID": "WBB",
          "ELEV_DEM": "4738",
          "LONGITUDE": "-111.84755",
          "STATE": "UT",
          "LATITUDE": "40.76623",
          "TIMEZONE": "America/Denver",
          "ID": "1",
          "OBSERVATIONS": {
            "precipitation": [
              {
                "count": 12,
                "first_report": "2017-01-31T23:00:00Z",
                "interval": 1,
                "report_type": "precip_accum_five_minute",
                "last_report": "2017-01-31T23:55:00Z",
                "total": 0
              }
            ]
          }
        }
      ],
      "SUMMARY": {
        "DATA_QUERY_TIME": 169.8219776154,
        "RESPONSE_CODE": 1,
        "RESPONSE_MESSAGE": "OK",
        "NUMBER_OF_OBJECTS": 1
      }
    }