Retrieve data via browser query

You can simply type an OData HTTP request in the address bar of a modern browser to query Historian Data API.

Note: Retrieval endpoints are unique for each Insight solution. The following examples use the endpoint "https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5", but yours will be different. Learn how to find the basic-authentication retrieval endpoint for your solution.

• List root entities

  This example lists the entities you can explore and submit additional queries against.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2

  For more information, see Resources.

• List data sources (tag groups)

  This shows the data sources (labeled "TagGroups" in this API) for your Insight solution. If you have accounts for more than one solution, this shows the data sources for your original Insight solution.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2/TagGroups

• List tag metadata for all tags

  This shows metadata for all tags in all data sources for your original Insight solution.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2/Tags

• List tag metadata for a data source

  This shows metadata for tags in a particular data source. The data source in this example is named Baytown.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2/Tags?$filter=Source+eq+'Baytown'

• List tag values for a data source

  This example expands on the last one. It uses a "$filter" clause that specifies a particular tag named tank_level within the Baytown data source. The result is a list of values for the tank_level tag.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2/ProcessValues?$filter=FQN+eq+'Baytown.tank_level'

• List tag values with analog summary data for a data source

  This example result is a list of values with analog summary for the tank_level tag.

  https://online.wonderware.[DOMAINSUFFIX]/s/ik97r5/apis/historian/v2/AnalogSummary?$filter=FQN+eq+'Baytown.tank_level'

  Notice that this example uses a fully qualified name ("Baytown.tank_level"), which is a combination of a data source name ("Baytown") and a tagname ("tank_level").