Export Device Data

This endpoint exports Device data in the selected format and sends it to the specified email.

Request

To export data of a Device please make a POST request to the following URL:

HTTP MethodURL
POSThttps://industrial.api.ubidots.com/api/v2.0/devices/<device_key>/_/values/export/

Path Parameters

ParameterTypeDescription
device_keyStringThe id or label of the Device, label should use the prefix ~

Query Parameters

ParameterTypeUseDescription
tokenStringAuthenticationAuthentication Token can optionally be sent as a query parameter.
emailStringRequired ParameterEmail to which exported data is sent to
startDateLongRequired ParameterIn milliseconds
endDateLongRequired ParameterIn milliseconds
timezoneStringDefault is "UTC" Allowed values are all times zones included in the pytz.all_timezones
formatStringAllowed values: csv | txt | json | xlsx
Default is csv.

Header

ParameterRequired?Description
X-Auth-TokenYes[Authentication Token] (/reference/authentication) of account
$ curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/devices/<device_key>/_/values/export/' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{"email": "[email protected]"}'
{
  "task": {
    "id": "5df7a0c81a9ca52c2bee6877"
  }
}
{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}
{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}

Response

Returns a Task Id of the asynchronous process.