Get Asset History

get

https://talk.perspio.io/assets/v3/objects/history

Fetch historical data of an asset.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids

string

required

Comma-separated list of asset IDs

from

date-time

required

Start time for historical data in ISO 8601 format

date-time

required

End time for historical data in ISO 8601 format

page_size

int32

required

Number of records to return per page

metrics

string

required

Comma-separated list of metrics to retrieve

type

string

Object type to return history for.

Headers

ContinuationToken

string

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

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.

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.

200Success

500Internal Server Error