Get variable data

To get a variable's Dots, make a GET request to the following URL:

HTTP Method	URL
GET	`https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/<variable_label>/values`

Where <device_label> and <variable_label> are the labels of the Device and Variable, respectively, from which values will be retrieved.

📘
Default behavior
By default, this endpoint retrieves the last 100 Dots of the specified variable. Use the query parameters to filter the request further.

Headers

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

Header	Value	Required?	Description
`X-Auth-Token`	Token	Yes	Authentication Token for the account.

Query Parameters

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

Parameter	Value	Type	Description
token	Token	String	The token to authenticate the request. While sending it as a query parameter is supported, we strongly recommend using the `X-Auth-Token` header.
page	Number	Integer	A page number within the paginated result set.
page_size	Number	Integer	The number of results to return per page.
start	Number	Integer	Initial POSIX timestamp in milliseconds for values of the variable (inclusive).
end	Number	Integer	Final POSIX timestamp in milliseconds for values of the variable (inclusive).
format	`json`, `csv`	String	The format for retrieving the data. Defaults to `json`.

Examples

Get the 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 the last two Dots of a variable:
Retrieves the last two Dots 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 for 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 for a variable from 21/10/2021 00:00:00 through 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 for a variable between 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."
}