Search Devices

Search Organization Devices

GET https://{server_address}/api/v1/organization/search/devices

sortBy query parameter could accept the following values: Device Id, Name (stands for device's name), Auth Token, Owner Id (stands for device's owner name), Device Owner Name, Device Owner (stands for device's owner email), Last Reported At, Activated At, Activated By (stands for email of user, that activated device), Model (stands for device's model), Template Name, Template Id, Firmware Version, Organization Id, Status (stands for device's status).

Query Parameters

NameTypeDescription

query*

Device name

Search query. Should be up to 255 symbols.

page

0

Page number starting from 0. First page by default.

size

20

Page size. Should be from 1 to 100. 20 by default.

sortBy

Device Id

Field to sort result by.

sortOrder

ASC

Sorting order. Could be ASC (ascending sort order) or DESC (descending sort order). ASC by default.

Headers

NameTypeDescription

Authorization*

Bearer {access_token}

{
   "content": [
      {
         "id": 165,
         "templateId": 353,
         "orgId": 577,
         "name": "My awesome device",
         "token": "etAxiiiYlDv4j7WCeb1pKW2Ck7UGWpgl",
         "activatedAt": 1702480139859,
         "ownerUserId": 879,
         "hardwareInfo": {
            "version": "1.0.0",
            "fwType": "TMPL0NqfCLjWX",
            "blynkVersion": "1.0.0",
            "boardType": "ESP8266",
            "build": "1",
            "templateId": "TMPL0NqfCLjWX"
         }
      }
   ],
   "totalElements": 1
}

Request examples:

# curl command example:
$ curl -H "Authorization: Bearer {accessToken}" https://fra1.blynk.cloud/api/v1/organization/search/devices?query=my+device+name
$ curl -H "Authorization: Bearer eIdWHQqRfFmvP5LDDh-IGxPUzi7I27HthzCPAVmS" https://fra1.blynk.cloud/api/v1/organization/search/devices?query=my+device+name

Last updated