API ReferenceData APIHelp CenterCommunityDevice TutorialsSample Projects
API Reference
LoginSign up

Send bulk data to a Device

This endpoint sends one or more Dots to Device

To send historical data (i.e. from data loggers) to one or more variables of a Device please make a POST request to the following URL:

HTTP MethodURL
POSThttps://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/_/bulk/values

Where <device_label> is a string with the label of the Device to which data will be sent to.

Headers

The "X-Auth-Token" and "Content-Type" headers are required to your request:

HeaderValueRequired?Description
X-Auth-TokenTokenYesAuthentication Token of account.
Content-Typeapplication/jsonYesThe type of data of the body.

Body

A list of objects, each containing a set of variable Dots and a global timestamp that will be applied to each value. Variables with an individual timestamp will override the global timestamp.

[
  {
    "timestamp":"1597620360000",
    "temperature": "2",
    "humidity": 88
  },
  {
    "timestamp":"1597620000000",
    "temperature": {"value": 23, "context": {}, "timestamp": 1597620000001},
    "humidity": 33
  },
  {
    "timestamp":"1597619760000",
    "temperature": 26,
    "humidity": 44
  }
]

🚧

Maximum length

The maximum character length for the body is 10kb

Query Parameters

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

ParameterTypeDescription
tokenStringThe token to authenticate the request.
While sending it as a query parameter is supported, we strongly recommend using the X-Auth-Token header
typeStringOptional Device Type label to be applied to the Device if the Device doesn't exist yet. Learn more

Examples

Send historical data to a Device:
Update a Device with historical data of its variables

$ curl -X POST 'https://industrial.api.ubidots.com/api/v1.6/devices/<device_label>/_/bulk/values' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '[
  {
    "timestamp":"1597620360000",
    "temperature": "2",
    "humidity": 88
  },
  {
    "timestamp":"1597620000000",
    "temperature": {"value": 23, "context": {}, "timestamp": 1597620000001},
    "humidity": 33
  },
  {
    "timestamp":"1597619760000",
    "temperature": 26,
    "humidity": 44
  }
]'

{
  "results": [
    {
      "humidity": [
        {
          "status_code": 201
        }
      ],
      "temperature": [
        {
          "status_code": 201
        }
      ]
    },
    {
      "humidity": [
        {
          "status_code": 201
        }
      ],
      "temperature": [
        {
          "status_code": 201
        }
      ]
    },
    {
      "humidity": [
        {
          "status_code": 201
        }
      ],
      "temperature": [
        {
          "status_code": 201
        }
      ]
    }
  ]
}

{
  "code": 400001,
  "message": "The payload sent is not a valid json document."
}

{
  "code": 401001,
  "message": "Authentication credentials were not provided."
}