curl --request GET \
--url https://app.trelica.com/api/assets/v1 \
--header 'Authorization: Bearer <token>'{
"next": "https://app.trelica.com/api/assets/v1?after=eyJpZCI6IjY0NmZjYjRmYjgyOWJhOWRmMmE5NDQ3MSJ9&limit=100",
"results": [
{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
]
}List devices
Returns a paginated list of the devices in your organization. Use filter and
q to narrow the results, and follow the next link (also provided in the
link response header) to page through large result sets.
Required scope: Assets.Read (Read-only access to devices)
curl --request GET \
--url https://app.trelica.com/api/assets/v1 \
--header 'Authorization: Bearer <token>'{
"next": "https://app.trelica.com/api/assets/v1?after=eyJpZCI6IjY0NmZjYjRmYjgyOWJhOWRmMmE5NDQ3MSJ9&limit=100",
"results": [
{
"id": "646fcb4fb829ba9df2a94471",
"status": "Deployed",
"statusType": "Deployed",
"hardwareVendor": "Apple Inc.",
"modelName": "MacBook Pro (16-inch, 2021)",
"serialNumber": "KOGITG04P5",
"assetTag": "A0000002",
"purchasedDate": "2016-03-06T00:00:00Z",
"warrantyExpirationDate": "2017-03-06T00:00:00Z",
"lifespanExpirationDate": "2019-03-06T00:00:00Z",
"assignedTo": {
"userId": "6a127db661b442c1afdd77611ad99824",
"name": "Joshua Burns",
"email": "joshua.burns@example.com"
},
"assignedToEmail": "joshua.burns@example.com",
"netPrice": 1615,
"netPriceCurrency": "USD",
"platform": "Mac",
"isEncrypted": false,
"customFields": {
"user_department": "Engineering",
"user_ram_gb": 32,
"user_accessories": [
"Charger",
"Dock"
]
},
"createdBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"createdDtm": "2023-05-25T20:55:43.048Z",
"lastModifiedBy": {
"userId": "b1fb51a7c13f4cbf832b304348c8270e",
"name": "System",
"email": "admin@example.com"
},
"lastModifiedDtm": "2024-05-27T01:03:26.679Z"
}
]
}Authorizations
OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.
Query Parameters
A SCIM-style filter expression restricting the items returned. See the Filtering section of the introduction for the operators and syntax; the filterable fields are listed per resource.
Filterable fields
- string:
assetTag,assignedTo.email,assignedTo.name,assignedTo.userId,assignedToEmail,createdBy.email,createdBy.name,createdBy.userId,description,deviceName,hardwareVendor,id,lastModifiedBy.email,lastModifiedBy.name,lastModifiedBy.userId,location.countryCode,location.id,location.name,locationName,modelName,netPriceCurrency,notes,osVersion,platform,serialNumber,status,supplier - number:
netPrice - date:
createdDtm,disposalDate,enrolledDtm,lastModifiedDtm,lastSyncDtm,lifespanExpirationDate,purchasedDate,warrantyExpirationDate - boolean:
deleted,isEncrypted - custom fields:
customFields.<name>
Filter examples
hardwareVendor co "Dell"— Devices whose vendor contains "Dell", e.g. "Dell Inc.", "Dell Boomi"status eq "Deployed"— Deployed devicescustomFields.memoryGb gt 12— Devices where the custom field "memoryGb" is greater than 12not (lastSyncDtm pr)— Devices with no last sync date
Free-text search across the resource's displayable fields.
Only return items modified at or after this ISO-8601 timestamp.
Only return items modified at or before this ISO-8601 timestamp.
Opaque pagination cursor supplied by SaaS Manager via the link response header and the next field.
Maximum number of items to return per page (default 100, maximum 1000).
1 <= x <= 1000Was this page helpful?