Get variable data

To get Dots of a variable please 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 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:

Header	Value	Required?	Description
`X-Auth-Token`	Token	Yes	Authentication Token of 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	Number of results to return per page.
start	Number	Integer	Initial timestamp in milliseconds POSIX format for values of the variable (inclusive).
end	Number	Integer	Final timestamp in milliseconds POSIX format for values of the variable (inclusive).
format	`json`, `csv`	String	Format 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."
}

📘Default behaviour

Headers

Query Parameters

Examples

📘
Default behaviour