Get an asset
Returns a single asset with full details
Returns a single asset with its full details.
Harmony access key, sent as Authorization: AccessKey <your-key>. Create keys in Settings > Access Keys. The tenant is resolved from the key.
Human-readable asset identifier (e.g. LP-DL-6sNdq). Not the UUID.
Include custom field config metadata
falseSuccessful Response
Internal database UUID
Human-readable asset identifier (e.g. LP-DL-6sNdq) used in the detail endpoint path
Asset type enumeration for different asset categories.
Asset lifecycle status enumeration.
MDM-reported device status enumeration.
Sub-status for retired assets.
Custom notes for retirement disposition (required when retirement_sub_status=OTHER)
Asset ownership enumeration.
falseDevice compliance status.
Direct URL to the device in the MDM system
Whether the asset has an FDE recovery key stored
falseEmployee ID if asset is assigned to an employee
Display name of the assigned employee
Location of the assigned employee
Employee ID of the previous assignee before the last reassignment
Estimated price from catalog data. Used when no actual purchase price exists.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$What this asset sells for, the same figure the list endpoint reports. Also on purchase_details when the asset has one; here it is answered even for an asset with no purchase record, priced from the catalog estimate where the policy allows it.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$True when sale_price was derived from the catalog's estimated price because no purchase price is on record. Governed by the purchase policy's quote_from_estimate.
falseValidation Error
GET /asset-management/api/v1/assets/{asset_id} HTTP/1.1
Host: api.harmony.io
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"asset_id": "text",
"name": "text",
"serial_number": "text",
"manufacturer": "text",
"model": "text",
"family_name": "text",
"asset_type": "LAPTOP",
"status": "in_stock",
"mdm_status": "ACTIVE",
"retirement_sub_status": "auto_detected",
"retirement_notes": "text",
"ownership": "COMPANY_OWNED",
"for_sale": false,
"compliance": "COMPLIANT",
"source": "text",
"integration_id": "text",
"device_url": "https://example.com",
"last_seen": "2026-01-01T00:00:00.000Z",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"device": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"mdm_device_id": "text",
"os_type": "text",
"os_version": "text",
"os_build": "text",
"os_release_name": "text",
"os_version_display": "text",
"is_managed": true,
"enrollment_date": "2026-01-01T00:00:00.000Z",
"last_restart_time": "2026-01-01T00:00:00.000Z",
"cpu_type": "text",
"cpu_cores": 1,
"memory_total_gb": "text",
"battery_health": "NORMAL",
"battery_cycles": 1,
"battery_info": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"network_interfaces": [
{
"interface_name": "text",
"interface_type": "text",
"mac_address": "text",
"ip_address": "text",
"is_active": false,
"is_primary": false,
"connection_status": "text"
}
],
"disks": [
{
"name": "text",
"identifier": "text",
"file_system": "text",
"total_capacity_gb": "text",
"available_capacity_gb": "text",
"is_encrypted": true,
"encryption_method": "FileVault"
}
],
"edr_data": {
"provider": "SENTINELONE",
"agent_version": "text",
"is_outdated": false,
"agent_status": "active",
"last_scan_at": "2026-01-01T00:00:00.000Z",
"active_threats": 0,
"protection_features": [
{
"name": "text",
"enabled": true
}
],
"applied_policies": [
{
"name": "text",
"type": "text",
"applied": true
}
],
"threats": [
{
"name": "text",
"severity": "text",
"category": "text",
"status": "text",
"detected_at": "2026-01-01T00:00:00.000Z",
"mitre_tactic": "text",
"mitre_technique": "text",
"id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"last_synced_at": "2026-01-01T00:00:00.000Z",
"edr_url": "https://example.com"
},
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
},
"purchase_details": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"purchase_number": "text",
"supplier": "text",
"price": "text",
"purchase_date": "2026-01-01",
"warranty_type": "STANDARD",
"warranty_description": "text",
"warranty_end_date": "2026-01-01",
"sale_price": "text",
"sale_price_estimated": false,
"sale_price_mode": "POLICY_BASED",
"manual_sale_price": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
},
"note": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"asset_id": "123e4567-e89b-12d3-a456-426614174000",
"note_text": "text",
"updated_by": "text",
"updated_at": "2026-01-01T00:00:00.000Z"
},
"procurement": {
"provider": "text",
"provider_item_id": "text",
"provider_order_id": "text",
"order_number": "text",
"order_status": "text",
"order_date": "2026-01-01T00:00:00.000Z",
"delivery_date": "2026-01-01T00:00:00.000Z",
"condition": "text",
"warehouse_name": "text",
"warehouse_country": "text",
"price": "text",
"currency": "text",
"supplier": "text",
"article_code": "text",
"asset_url": "text",
"order_url": "text"
},
"has_fde_key": false,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"employee_id": "text",
"employee_name": "text",
"employee_location": "text",
"former_assignee": "text",
"location": {
"city": "text",
"state": "text",
"country": "text",
"country_code": "text",
"region": "text",
"region_code": "text",
"region_type": "text",
"manual": "text",
"pinned": false
},
"estimated_price": "text",
"sale_price": "text",
"sale_price_estimated": false,
"eol_date": "2026-01-01",
"days_until_eol": 1,
"custom_fields": {
"ANY_ADDITIONAL_PROPERTY": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"custom_fields_with_config": {
"ANY_ADDITIONAL_PROPERTY": {
"ANY_ADDITIONAL_PROPERTY": {
"value": "text",
"label": "text",
"type": "number",
"required": false,
"options": [
"text"
]
}
}
},
"physical_asset_id": "123e4567-e89b-12d3-a456-426614174000"
}Last updated
Was this helpful?