HomeGuidesAPI Reference
API Reference
Status PageHelp CentrePerspio Portal

Global Search

get
https://talk.perspio.io/search/v3/

Search the tenant's system-object cache - assets, devices, asset groups, geofences and rules - by free text, optionally restricted to a single Perspio object type and a set of asset types. Returns the matching objects grouped by type.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
string

Restrict the search to a single Perspio object type (asset, device, assetGroup, geofence, rule).

integer
Defaults to 10
assetTypeIds
array of integers
assetTypeIds
Headers
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}

Responses

401

Invalid API Key provided or Invalid Bearer token

Updated 11 days ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 11 days ago

Did this page help you?