IRIS360 PUBLIC API
  1. Entities
IRIS360 PUBLIC API
  • iris360
    • Timeseries
      • Get Timeseries
    • Entities
      • Paginate Entitites
        POST
      • Get entity latest data
        GET
    • Auth
      • Get user token
      • Refresh user token
    • Connectors
      • Out
        • Paginate Connectors
        • Update Connector Models
        • Get Connector
    • Devices
      • Paginate Devices
      • Import file
      • Send Commands in Bulk
  1. Entities

Get entity latest data

Developing
GET
/api/public/v1/last-data/entities/{urn}
This endpoint returns the latest data related to this entity (Attributes). No historical information is managed in this request. Entities can have multiple properties:
Attributes: Measurement data, that can be provided by a device or be virtually managed.
Relationships: These point to other entities that somehow relate to the actual entity.
Commands: Some entities are capable of executing some commands (usually, configuration commands for real IoT devices). A command describes what kind of data can be processed by the entity.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Query Params

Header Params

Body Params application/json

Example
{
    "attrTypeFilter": [
        "Property"
    ],
    "attrNameFilter": "string",
    "attrPropFilter": [
        "string"
    ],
    "attrRelFilter": [
        "string"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/public/v1/last-data/entities/urn:ngsi-ld:Device:Device001' \
--header 'tenant: OrganizationA' \
--header 'scope: /' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "attrTypeFilter": [
        "Property"
    ],
    "attrNameFilter": "string",
    "attrPropFilter": [
        "string"
    ],
    "attrRelFilter": [
        "string"
    ]
}'

Responses

🟢200Success
application/json
Body

Example
[
    {
        "urn": "urn:ngsi-ld:Device:Device001",
        "tenant": "OrganizationA",
        "scope": "/",
        "id": "o3",
        "name": "O3",
        "value": 40.720798,
        "type": "Property",
        "description": "No info available",
        "units": "ppm",
        "timestamp": "2025-01-01 10:50:00"
    },
    {
        "urn": "urn:ngsi-ld:Device:Device001",
        "id": "cmd1",
        "name": "CMD1",
        "status": null,
        "info": null,
        "status_timestamp": null,
        "info_timestamp": null,
        "timestamp": null,
        "type": "Command",
        "available": true,
        "pending": false,
        "pending_value": null,
        "current_value": 1,
        "description": "Device sample configuration command",
        "data_type": "bool",
        "units": null,
        "max_value": null,
        "min_value": null,
        "internal": false,
        "operations": "rw"
    }
]
Modified at 2025-01-27 08:44:29
Previous
Paginate Entitites
Next
Get user token
Built with