Developers
Mesonet API
  • Getting Started
  • Reference
  • Explorer
  • Examples
  • Pricing
  • Quality Control Segments Service

    Mesonet API Services

    Returns data for a station or set of stations for a time span

    QC Segments

    Request Format

    A QC Segments request is an HTTP URL with the following form:

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

    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.

    Optional Parameters

    The following example will request all the stations in Utah with an open QC segment within the last two hours:

    https://api.synopticdata.com/v2/stations/qcsegments?state=ut&recent=120&token=YOUR_TOKEN_HERE
    

    The following example will request only the QC segments for air temperature at KSLC (Salt Lake City Airport) on January 3, 2015:

    https://api.synopticdata.com/v2/stations/qcsegments?stid=kslc&start=201501030000&end=201501032359&vars=air_temp&token=YOUR_TOKEN_HERE
    

    Response Format Parameters

    Request Response

    JSON Format

    The QC Segments 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:

    {
      "QC_SHORTNAMES": {
        "78": "sl_multvariate_lin_reg_check",
        "80": "sl_uu2dvar_rejection"
      },
      "QC_SOURCENAMES": {
        "78": "SynopticLabs",
        "80": "SynopticLabs"
      },
      "STATION": [
        {
          "STATUS": "ACTIVE",
          "MNET_ID": "195",
          "PERIOD_OF_RECORD": {
            "start": "2014-03-20T00:00:00Z",
            "end": "2018-01-22T02:00:00Z"
          },
          "ELEVATION": "3885",
          "NAME": "ARNOLD CA",
          "DISTANCE": 7.77,
          "RESTRICTED": false,
          "STID": "ARLC1",
          "STATE": "CA",
          "LATITUDE": "38.23",
          "TIMEZONE": "America/Los_Angeles",
          "ID": "42541",
          "ELEV_DEM": "3819",
          "LONGITUDE": "-120.36",
          "SENSOR_VARIABLES": {
            "air_temp": { "air_temp_qc_1": {} }
          },
          "QC": [
            {
              "start": "2018-01-21T17:00:00Z",
              "qc_flag": 78,
              "sensor": "air_temp_qc_1",
              "end": "2018-01-21T17:00:00Z",
              "is_open": true
            },
            {
              "start": "2018-01-21T17:00:00Z",
              "qc_flag": 80,
              "sensor": "air_temp_qc_1",
              "end": "2018-01-21T17:00:00Z",
              "is_open": false
            }
          ]
        }
      ],
      "SUMMARY": {
        "RESPONSE_CODE": 1,
        "RESPONSE_MESSAGE": "OK",
        "TOTAL_DATA_TIME": "14.3580436707 ms",
        "NUMBER_OF_OBJECTS": 17
      }
    }
    

    Note: The data in this example is simulated.