List assets

get

https://api.sensos.io/v1/accounts/{accountId}/assets

Retrieve a paginated list of assets belonging to the specified account, most recently modified first. Supports filtering by name, type, device ID, set ID, health status and related point of interest.

Path Params

accountId

string

required

The account ID.

Query Params

name

string

Filter assets by name (case-insensitive). Supports * as a wildcard, for example *text*, text* or *text.

type

string

enum

Filter by asset type.

deviceId

string

Filter by paired device ID.

setId

uuid

Filter by set ID.

healthStatus

string

enum

Filter by health status.

Allowed:

relatedPointOfInterestId

string

Filter by related point of interest ID.

cursor

string

Opaque cursor from metadata.nextCursor of the previous page. Cursors expire after 2 days; an invalid or expired cursor returns 400.

limit

int32

≤ 100

Defaults to 50

Maximum number of records per page (default 50, maximum 100). Values outside 1-100 are clamped.

includeTotal

boolean

Defaults to false

When true, metadata.total contains the total number of matching records.

Responses

401

Missing, invalid or expired access token. Returned by the gateway with an empty body.

403

The token lacks the required permission, the account is not accessible to it, or the tenant is inactive. Returned by the gateway with an empty body.

200Paginated list of assets.

400Invalid request. Field and query validation failures return ValidationProblemDetails; business-rule failures return ErrorResponse.