Skip to main content

Query assets by given identifiers

POST 
/v2/assets/query

Query assets by identifier type and values. Returns assets that match any of the provided identifiers.

Supported identifier types:

  • ASSET_ID : Basic asset identifier, references Asset.id field
  • ASSET_NAME : Asset name, references Asset.name field
  • ASSET_EXTERNAL_REFERENCE : Asset external reference, references Asset.externalReference field
  • ASSET_SERIAL_NUMBER : Asset serial number, references Asset.serialNumber field
  • DEVICE_SERIAL_NUMBER : Telematics device serial number, references TelematicsDevice.serialNumber field

Results are filtered by user permissions - only assets the user can view are returned. If no matching assets are found, an empty list is returned.

Maximum 2000 identifiers can be queried in a single request.

Request​

Responses​

OK