Assets APIs
Use the Assets APIs to query your asset inventory in real time. These synchronous REST endpoints let you list assets, get total counts, group assets by any supported field, and look up a specific asset by its ID.
Your account identity is automatically derived from your JWT token, so you do not need to include a customer ID in any request.
Available Assets APIs
|
API Name |
Endpoint |
Description |
|---|---|---|
| List Assets API | POST/etm/api/rest/v1/assets/list | Use this API to get a list of assets. |
| Get Asset by ID API | GET/etm/api/rest/v1/assets/{asset-id} | Use this API to get the details of an asset using the asset ID. |
| Count Asset API | POST/etm/api/rest/v1/assets/count | Use this API to get the count of assets matching the specified query criteria. |
| Group Asset API | POST/etm/api/rest/v1/assets/group | Use this API to group assets by one or more fields and get aggregated counts for each group. |
Authentication
All Assets API endpoints require a valid Bearer JWT token in the request header:
Authorization: Bearer <your-jwt-token> Rate Limits
Assets API endpoints share the combined Inventory API rate limit of 300 requests per minute per customer. List operations return a maximum of 1,000 records per page; use pagination tokens to retrieve additional pages. Group operations return up to 1,000 buckets, sorted by count in descending order.
Count and group operations reflect full, accurate totals and are not subject to the 1,000-record page limit.
Requests that exceed the rate limit receive an HTTP 429 response; retry after the period indicated in the Retry-After response header.