This endpoint retrieves variable Dots

To get Dots of a variable please make a GET request to the following URL:

HTTP MethodURL
GEThttps://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values

Where <device_label> and <variable_label> are the label of the Device and Variable, respectively, from which the last value will retrieved.

📘

Default behaviour

By default, this endpoint will retrieve the last 100 Dots of the specified variable. Use the query params to filter the request further.

Headers

The "X-Auth-Token" header is required for your request:

HeaderValueRequired?Description
X-Auth-TokenTokenYesAuthentication Token of account.

Query Parameters

You may add optional parameters to the URL of your request:

ParameterValueTypeDescription
tokenTokenStringThe token to authenticate the request.
While sending it as a query parameter is supported, we strongly recommend using the X-Auth-Token header
pageNumberIntegerA page number within the paginated result set.
page_sizeNumberIntegerNumber of results to return per page.
startNumberIntegerInitial timestamp in milliseconds POSIX format for values of the variable (inclusive).
endNumberIntegerFinal timestamp in milliseconds POSIX format for values of the variable (inclusive).
formatjson, csvStringFormat to retrieve the data.
Defaults to json

Examples

Get last Dot of a variable:
Retrieves the last Dot of a variable

$ curl -X GET 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values/?page_size=1' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
{
  "count": true,
  "next": "https://industrial.api.ubidots.com/api/v1.6/devices/demo/demo/values/?page_size=1&page=2",
  "previous": null,
  "results": [
    {
      "timestamp": 1635264014782,
      "value": 0,
      "context": {},
      "created_at": 1635264014782
    }
  ]
}
{
  "code": 401002, 
  "message": "Incorrect authentication credentials."
}

Get last two Dots of a variable:
Retrieves the last two Dot of a variable

$ curl -X GET 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values/?page_size=2' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
{
  "count": true,
  "next": "https://industrial.api.ubidots.com/api/v1.6/devices/demo/demo/values/?page_size=2&page=2",
  "previous": null,
  "results": [
    {
      "timestamp": 1635264014782,
      "value": 0,
      "context": {},
      "created_at": 1635264014782
    },
    {
      "timestamp": 1635264000173,
      "value": 0,
      "context": {},
      "created_at": 1635264000173
    }
  ]
}
{
  "code": 401002, 
  "message": "Incorrect authentication credentials."
}

Get Dots of a variable in a time range:
Retrieves a list of Dots of a variable between 21/10/2021 00:00:00 and 21/10/2021 00:30:00

$ curl -X GET 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values/?start=1634792400000&end=1634794200000' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
{
  "count": true,
  "next": null,
  "previous": null,
  "results": [
    {
      "timestamp": 1634793902308,
      "value": 65084.81,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634793902308
    },
    {
      "timestamp": 1634793603356,
      "value": 65006.39,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634793603356
    },
    {
      "timestamp": 1634793302168,
      "value": 65120.26,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634793302168
    },
    {
      "timestamp": 1634793002218,
      "value": 65085.38,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634793002218
    },
    {
      "timestamp": 1634792701662,
      "value": 64896.85,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634792701662
    },
    {
      "timestamp": 1634792406359,
      "value": 65114.12,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1634792406359
    }
  ]
}
{
  "code": 401002, 
  "message": "Incorrect authentication credentials."
}

Get Dots of a variable from a date:
Retrieves a list of Dots of a variable from 21/10/2021 00:00:00 up to today

$ curl -X GET 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values/?start=1634792400000' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
// The "results" list has been chunked because it is too long
{
  "count": true,
  "next": "https://industrial.api.ubidots.com/api/v1.6/devices/foreignexchange/bitcoin/values/?start=1634792400000&page=2",
  "previous": null,
  "results": [
    {
      "timestamp": 1635368101148,
      "value": 58920.82,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1635368101148
    },
    ···
    ,
    {
      "timestamp": 1635367802869,
      "value": 58759.25,
      "context": {
        "Currency": "USD"
      },
      "created_at": 1635367802869
    }
  ] 
}
{
  "code": 401002, 
  "message": "Incorrect authentication credentials."
}

Get Dots of a variable in a time range in CSV format:
Retrieves a list of Dots of a variable from 21/10/2021 00:00:00 and 21/10/2021 00:30:00 in CSV format

$ curl -X GET 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values/?start=1634792400000&end=1634794200000&format=csv' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73'
context.Currency,created_at,human_readable_date,timestamp,value
USD,1634793902308,2021-10-21 01:25:02.308000-04:00,1634793902308,65084.81
USD,1634793603356,2021-10-21 01:20:03.356000-04:00,1634793603356,65006.39
USD,1634793302168,2021-10-21 01:15:02.168000-04:00,1634793302168,65120.26
USD,1634793002218,2021-10-21 01:10:02.218000-04:00,1634793002218,65085.38
USD,1634792701662,2021-10-21 01:05:01.662000-04:00,1634792701662,64896.85
USD,1634792406359,2021-10-21 01:00:06.359000-04:00,1634792406359,65114.12
{
  "code": 401002, 
  "message": "Incorrect authentication credentials."
}