Skip to main content

Getting Data

info

When making a request to the TagoIO API, you must also specify the appropriate regional endpoint. Check out the available regions here: API documentation (link included in the original article).

Headers​

Include your device token in the Authorization header.

Authorization: Your-Device-Token

Endpoint​

Use the regional data endpoint:

GET https://api.<region>.tago.io/data

Query Parameters​

The following querystring parameters are supported:

KeyTypeDescriptionvariablestring or arrayGet variablesquerystringPre-defined by TagoIOqtystringMaximum number of data points to be returnedstart_datestringStart date (e.g., "1 day" or ISO string)end_datestringEnd date (e.g., "1 day" or ISO string)detailboolInclude additional JSON fields in the returned results

Response Example​

Below is a sample response when no query parameters are supplied:

{
  "status": true,
  "result": [
    {
      "id": "547e42847dbf3af122c02582",
      "location": {
        "coordinates": [41.878876, -87.635915],
        "type": "Point"
      },
      "time": "2014-12-02T22:51:48.005Z",
      "variable": "location"
    },
    {
      "id": "547e353d7dbf3af122c0257d",
      "time": "2014-12-02T21:55:09.301Z",
      "unit": "%",
      "value": 32,
      "variable": "fuel_level"
    },
    {
      "id": "547e41f97dbf3af122c02580",
      "time": "2014-12-02T22:49:29.777Z",
      "unit": "psi",
      "value": 25,
      "variable": "oil_pressure"
    }
  ]
}

Variables​

The variable parameter specifies which variable(s) to return. Example for a single variable:

https://api.<region>.tago.io/data?variable=temperature

To request multiple variables, use an array syntax:

https://api.<region>.tago.io/data?variable[]=temperature&variable[]=pressure

Query​

The query parameter triggers predefined functions. Only one query can be used per request.

QueryDescriptionlast_itemReturns the most recent data point based on _time_.last_valueReturns the most recent data point that contains a _value_ field.last_locationReturns the most recent data point that contains a _location_ field.

Example:

https://api.<region>.tago.io/data?variable=temperature&query=last_item

Quantity​

The qty parameter limits how many results are returned (default 15).

Example to retrieve 99 records:

https://api.<region>.tago.io/data?variable=temperature&qty=99

Start Date – End Date​

Use start_date and end_date to filter data between two timestamps. They accept various formats, including relative time expressions.

Example:

https://api.<region>.tago.io/data?variable=temperature&start_date=2014-12-25&end_date=2014-12-26

If the interval contains more than 15 items, add qty to increase the limit.

Date Formats​

FormatExampleISO string2014-12-25T23:33:22.000ZHuman readable2014-12-25 23:33:22Relative1 day, 1 month, 1 year

Relative dates are calculated from the current time.

Rate Limits​

When executing requests to TagoIO, you will have a limit on the number of requests that can be made during a certain time period. Read more about our Rate Limits.