DataStreams

Device datastream operations

Get device datastream values

get

Retrieve current values for datastreams of a device using datastream IDs

Required permissions, when user-scoped authentication is used: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens can read datastreams only for owned devices unless ORG_DEVICES_VIEW is granted.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Query parameters

deviceIdinteger · int32Required

Device ID

dataStreamIdsinteger · int32[]Optional

Optional list of datastream IDs to filter results

Responses

200

Datastream values

application/json

403

Forbidden

404

Device not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

get

/api/v2/organization/device/datastreams

GET /api/v2/organization/device/datastreams?deviceId=1 HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "dataStreams": [
    {
      "dataStreamId": 201,
      "pin": "v10",
      "dataStreamLabel": "Temperature_Sensor",
      "dataStreamAlias": "Temperature Sensor",
      "value": "Some DataStream Value",
      "updatedAt": 1707245800000
    }
  ]
}

Get datastreams values for multiple devices

get

Retrieve current values for datastreams across multiple devices in batch. Maximum of 10 devices per request.

If any device is not found or you don't have access to it, the device will be ignored.

Required permissions, when user-scoped authentication is used: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens return data only for owned devices unless ORG_DEVICES_VIEW is granted; inaccessible devices are skipped.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Query parameters

deviceIdsinteger · int32[] · max: 10Required

List of device IDs

dataStreamIdsinteger · int32[]Optional

Optional list of datastream IDs to filter results

Responses

200

Batch datastream values

application/json

deviceIdinteger · int32RequiredExample: 101

403

Forbidden

429

Too many requests

500

Internal server error

application/json

get

/api/v1/organization/device/datastreams/batch

GET /api/v1/organization/device/datastreams/batch?deviceIds=1 HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "deviceId": 101,
    "dataStreams": [
      {
        "dataStreamId": 201,
        "pin": "v10",
        "dataStreamLabel": "Temperature_Sensor",
        "dataStreamAlias": "Temperature Sensor",
        "value": "Some DataStream Value",
        "updatedAt": 1707245800000
      }
    ]
  }
]

Get datastream history

get

Retrieve historical data for a specific datastream

Required permissions, when user-scoped authentication is used: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens can read history only for owned devices unless ORG_DEVICES_VIEW is granted.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Query parameters

deviceIdinteger · int32Required

Device ID

dataStreamIdinteger · int32Required

DataStream ID (alternative to pin)

frominteger · int64Required

Start timestamp (Unix epoch milliseconds)

tointeger · int64Required

End timestamp (Unix epoch milliseconds)

pageinteger · int32Optional

Page number (0-indexed)

Default: 0

sizeinteger · int32 · min: 1 · max: 1000Optional

Page size (max 1000)

Default: 50

Responses

200

Historical data

application/json

totalElementsinteger · int64RequiredExample: 1

400

Bad request

application/json

403

Forbidden

404

Device/datastream not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

get

/api/v1/organization/device/datastream/history

GET /api/v1/organization/device/datastream/history?deviceId=1&dataStreamId=1&from=1&to=1 HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "content": [
    {
      "value": 22.2,
      "createdAt": 1625247600000
    }
  ],
  "totalElements": 1
}

Update single datastream value

post

Update the value of a specific datastream

Required permissions, when user-scoped authentication is used: ORG_DEVICES_CONTROL. Required device view permission: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens can update datastreams only for owned devices unless ORG_DEVICES_VIEW is granted.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

deviceIdinteger · int32Required

Device ID

Example: 101

dataStreamIdinteger · int32Required

DataStream ID

Example: 1

valueone ofRequired

stringOptional

String datastream value

Example: Some DataStream Value

number · doubleOptional

Double, integer or enum datastream value

Example: 22.2

number · double[] · min: 2 · max: 2Optional

Location datastream value. Represented as an array of two elements, where the first is longitude, and the second is latitude.

Example: [13.38886,52.517037]

Responses

204

Datastream updated successfully

400

Bad request - Invalid value

application/json

403

Forbidden

404

Device/datastream not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/v1/organization/device/datastream

POST /api/v1/organization/device/datastream HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "deviceId": 101,
  "dataStreamId": 1,
  "value": "Some DataStream Value"
}

No content

Update multiple datastream values

post

Update values for multiple datastreams of a single device.

Invalid datastream IDs or values with mismatched types are silently skipped (no error is returned for individual entries).

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

deviceIdinteger · int32Required

Device ID

Example: 101

Responses

204

Datastreams updated successfully

400

Bad request - Invalid values

application/json

403

Forbidden

404

Device not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/v1/organization/device/datastreams

POST /api/v1/organization/device/datastreams HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "deviceId": 101,
  "values": {
    "v1": "Some String DS value",
    "v2": 22.3
  }
}

No content

Import batch data

post

Import historical data for device in batch.

A per-device rate limit applies to import operations. Data points with timestamps more than 1 month in the future are silently skipped. Maximum of 10,000 data points per request.

Required permissions, when user-scoped authentication is used: ORG_DEVICE_DATA_IMPORT. Required device view permission: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens can import data only for owned devices unless ORG_DEVICES_VIEW is granted.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

deviceIdinteger · int32Required

Device ID

Example: 101

dataStreamIdinteger · int32Required

DataStream ID

Example: 1

Responses

204

Import accepted and processing asynchronously

400

Bad request

application/json

403

Forbidden

404

Device not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/v1/organization/device/import/batch

POST /api/v1/organization/device/import/batch HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "deviceId": 101,
  "dataStreamId": 1,
  "values": [
    {
      "value": "Some DataStream Value",
      "ts": 1625247600000
    }
  ]
}

No content

Update datastream widget property

post

Update a widget property for a datastream (label, color, min, max, etc.).

The value must be in the correct format for the given property. Returns 400 if the format is invalid.

Required permissions, when user-scoped authentication is used: ORG_DEVICES_CONTROL. Required device view permission: OWN_DEVICES_VIEW or ORG_DEVICES_VIEW. User-scoped tokens can update properties only for owned devices unless ORG_DEVICES_VIEW is granted.

Authorizations

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

deviceIdinteger · int32Required

Device ID

Example: 101

dataStreamIdinteger · int32Required

DataStream ID

Example: 1

propertystring · enumRequired

Widget property to update

Example: colorPossible values:

valuestring · max: 200Required

New property value

Example: #FF0000

Responses

204

Property updated successfully

400

Bad request

application/json

403

Forbidden

404

Device/datastream/property not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/v1/organization/device/datastream/property

POST /api/v1/organization/device/datastream/property HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "deviceId": 101,
  "dataStreamId": 1,
  "property": "color",
  "value": "#FF0000"
}

No content

PreviousDevices NextProvisioning

Last updated 1 day ago

Was this helpful?

hashtagGet device datastream values

hashtagGet datastreams values for multiple devices

hashtagGet datastream history

hashtagUpdate single datastream value

hashtagUpdate multiple datastream values

hashtagImport batch data

hashtagUpdate datastream widget property

Get device datastream values

Get datastreams values for multiple devices

Get datastream history

Update single datastream value

Update multiple datastream values

Import batch data

Update datastream widget property