List items

get

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

Retrieve the items of an account, most recently modified first.

Path Params

accountId

string

required

ID of the account. An account you don't have access to returns 403.

Query Params

type

string

enum

Filter by item type.

Allowed:

sku

string

Filter SKU items by SKU. Case-insensitive; supports * as a wildcard (for example ABC*).

skuItemId

string

Filter serial-number items by the ID of their SKU item.

serialNumber

string

Filter serial-number items by serial number. Case-insensitive; supports * as a wildcard.

string

Free-text search across item properties. Case-insensitive.

cursor

string

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

limit

int32

≤ 100

Defaults to 50

Maximum number of results per page. Default 50, maximum 100; values outside 1-100 are clamped.

includeTotal

boolean

Defaults to false

When true, the response includes metadata.total.

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 the caller, or the tenant is inactive. Returned by the gateway with an empty body.

200Success

400Invalid query parameter or cursor.