Fetch and explore system object data

get

https://talk.perspio.io/assets/v3/data

Fetch system object data for assets, devices, events, etc. Supports filtering, field selection, and pagination.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

dataType

string

enum

required

Type of data to retrieve

scope

string

Asset scope (serialized object or ID)

ids

string

Comma-separated list of object IDs

signals

string

Comma-separated list of signal/field names

options

string

Comma-separated list of options (e.g., insidegeofence, locationupdate, relateddevices, outofdaterange)

condition

string

Serialized rule/condition for advanced filtering

from

date-time

Start date/time (ISO 8601)

date-time

End date/time (ISO 8601)

page_size

integer

≥ 1

Defaults to 50

Number of items per page

Headers

x-perspio-filter

string

Global data filter (JSON-serialised) scoping results to matching assets. Optional keys, each an array of strings: locationHierarchyL1..L3, productHierarchyL1..L3, operationalHierarchyL1..L3, groupIds; plus boolean 'enabled'. Omit for no additional filtering (security-group scoping always applies). Example: {"locationHierarchyL1":["NSW"],"enabled":true}

includedisabledassets

boolean

When true, disabled assets are included in the tenant scope applied to this request. Defaults to false.

ContinuationToken

string

Opaque token from a previous response's ContinuationToken header, to fetch the next page.

Responses

400

Invalid Request

401

Unauthorized. The response body's error code identifies which credential failed: invalid_subscription_key, invalid_token, expired_token, or invalid_tenant.

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

500Internal Server Error