Asset Detail

Retrieve detailed information about a single asset by its serial number.

GET

/api/v1/assets/details/{{serial_number}}

Description

Returns a single asset detail record for the exact serial number. The payload includes:

Asset: identity and configuration (asset_id/asset_number, model/model_number/sku/serial_number, condition, product/type/status, purchase info, date/cost/type, manufacturer/vendor, warranty window, key specs like processor/memory/storage/OS, network identifiers, security fields, location, department, customer label).
Assigned User (inside asset): assignee's name and email.
Finances: Financial lines relevant to capitalization/depreciation (if present).
History: Chronological lifecycle events with timestamp, activity, description, and actor.

This is a single-record lookup (no pagination). Dates are returned in human-readable format; convert client-side if needed.

Request

Path Parameters

Parameter	Type	Required	Description
serial_number	string	Yes	Serial number of the asset

Related Endpoints

List Assets

Get all assets in the system

Assign Assets

Assign an asset to a user

Did this page help you?

Request

curl -X GET https://dev-api.unduit.com/api/v1/assets/details/DL55243DF \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Success Response (200)

{
  "assetDetail": {
    "asset": {
      "price": 45,
      "asset_name": null,
      "model_number": "465867575435",
      "asset_id": "",
      "customer_asset_id": "1234345352",
      "sku": "2134136456",
      "serial_number": "234125347565",
      "condition": "New",
      "processor_name": "Intel Core i7",
      "memory": "8 GB",
      "storage": "512 GB SSD",
      "os": "Ubuntu 22.04",
      "purchase_date": "2025-09-11",
      "warranty_start": "2025-09-12",
      "warranty_expire": "2025-09-30",
      "mac_address": "1.13.3.13.1.3",
      "ip_address": "1.3.2.13.1.3.1.31",
      "antivirus": "Installed",
      "encryption": "Enabled",
      "asset_assign_date": "",
      "warranty_type": "Manufacturer",
      "currency_symbol": "",
      "currency_code": "",
      "imei": "",
      "imei2": "",
      "mdm_status": "",
      "printer_type": "",
      "print_resolution": "",
      "screen_size": "",
      "aspect_ratio": "",
      "checkin_date": null,
      "checkout_date": null,
      "asset_number": "2713120250911073936",
      "is_exception": 0,
      "mdm_type": null,
      "resolution": "",
      "purchase_date_formatted": "Sep 11, 2025",
      "warranty_start_formatted": "Sep 12, 2025",
      "warranty_expire_formatted": "Sep 30, 2025",
      "is_os_disabled": false,
      "is_model_id_disabled": false,
      "is_serial_number_disabled": false,
      "is_assign_to_disabled": false,
      "is_memory_disabled": false,
      "is_storage_disabled": false,
      "is_mac_address_disabled": false,
      "is_encryption_disabled": false,
      "is_customer_asset_id_disabled": false,
      "is_processor_name_disabled": false,
      "is_ip_address_disabled": false,
      "assigned_user": {
        "firstname": "Muhammad",
        "lastname": "Shahzad",
        "email": "[email protected]"
      },
      "asset_location": {
        "is_warehouse": 0,
        "location_name": "US"
      },
      "manage_configure_product": {
        "title": "API Asset",
        "useful_life": "12",
        "useful_life_type": "Years",
        "salvage_value": "30",
        "configure_manufacturer": {
          "name": "Dell Inc."
        },
        "manage_configure_depreciation": {
          "title": "Double Declining Balance"
        }
      },
      "asset_type": "Laptop",
      "model": null,
      "manufacturer": "Dell Inc.",
      "purchase_cost": 45,
      "custom_label": "1234345352",
      "configure_product_type": {
        "product_type": "Laptop"
      },
      "manage_configure_status": {
        "status_name": "In Use",
        "status_type": 2
      },
      "configure_department": {
        "department_name": "IT Department"
      },
      "configure_vendor": {
        "vendor": "Ricoh"
      }
    },
    "assetRecoveryInProgress": null,
    "finances": [
      {
        "month": 1,
        "date": "Sep 2025",
        "starting_book_value": "45.00",
        "depreciation_amount": "7.50",
        "acc_depreciation_amount": "7.50",
        "book_value": "37.50",
        "remaining_life": "0 year(s) 11 month(s)"
      }
    ],
    "history": [
      {
        "created_at": "Sep/11/2025 - Thu 07:39 AM",
        "status": null,
        "status_update_date": null,
        "old": 0,
        "activity": "Assigned",
        "description": "Asset assigned to Muhammad Shahzad",
        "user": {
          "firstname": "Umer",
          "lastname": "Rasheed",
          "email": "[email protected]"
        }
      },
      {
        "created_at": "Sep/11/2025 - Thu 07:39 AM",
        "status": "60",
        "status_update_date": null,
        "old": 0,
        "activity": "Asset Created",
        "description": "Asset created by Umer Rasheed",
        "user": {
          "firstname": "Umer",
          "lastname": "Rasheed",
          "email": "[email protected]"
        }
      }
    ]
  },
  "message": "Asset retrieved successfully."
}