Skip to main content
Get a list of assets with optional filtering.
External DocumentationTo learn more, visit the Device 42 documentation.

Basic Parameters

ParameterDescription
Asset IDThe ID of the asset to filter the results by.
Asset NumberAn asset number of an asset to filter the results by.
Include ColsSelect columns to include in the response.
Serial NumberSerial number of a an asset to filter the results by.
Service LevelThe service level of the assets to filter the results by.

Note: In Service, Spare, Not in Service are pre-defined options, you can also use custom ones.
TypeFilter the assets by their type.

Advanced Parameters

ParameterDescription
AND TagsA comma-separated list of tags to filter by (AND related - return results that include all the tags).
Asset Number ContainsReturns only assets whose asset number contains the specified value.
Custom Fields (AND)A comma-separated list of custom fields to filter the results by (AND). Format - key1:value1,key2:value2
Custom Fields (OR)A comma-separated list of custom fields to filter the results by (OR). Format - key1:value1,key2:value2
CustomerThe name of the customer to filter the results by.
First Added AfterFilter objects first added after or on the given date .
First Added BeforeFilter objects first added before the given date.
Last Updated AfterFilter objects last updated after or on the given date.
Last Updated BeforeFilter objects last updated before the given date.
Related Device IDThe ID of the related device to filter the results by.

Example Output

{
	"assets": [
		{
			"asset_contracts": [],
			"asset_id": 16,
			"asset_no": "0075",
			"asset_purchases": [],
			"building": "New Haven",
			"custom_fields": "",
			"depth": "Half Depth",
			"imagefile_id": 2,
			"name": "DC1R5PP1",
			"notes": "",
			"orientation": "Front",
			"patch_panel_model_id": 5,
			"rack": "NH-DC1-05",
			"rack_id": 24,
			"room": "NHDC1",
			"row": 2,
			"serial_no": "",
			"service_level": "In Service",
			"size": 2,
			"start_at": 40,
			"type": "Patch Panel",
			"vendor": "Black Box Corp.",
			"vendor_id": 36,
			"where": "Rack Mounted"
		}
	],
	"limit": 2,
	"offset": 0,
	"total_count": 209
}

Workflow Library Example

List Assets with Device 42 and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop
I