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>"

Success Response (200)

{
  "assetDetail": {
    "asset": {
      "price": 45,
      "asset_name": null,
      "model_number": "465867575435",
      "serial_number": "DL55243DF",
      "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_number": "2713120250911073936",
      "assigned_user": {
        "firstname": "Muhammad",
        "lastname": "Shahzad",
        "email": "muhammad.shahzad@unduit.com"
      },
      "asset_location": {
        "location_name": "US"
      },
      "manufacturer": "Dell Inc.",
      "purchase_cost": 45,
      "asset_type": "Laptop"
    },
    "message": "Asset retrieved successfully."
  }
}

Error Responses

400 Bad Request

{
  "message": "Serial number is required"
}

401 Unauthorized

{
  "message": "Authentication token is missing or invalid"
}

403 Forbidden

{
  "message": "Insufficient permissions to access this resource"
}

404 Not Found

{
  "message": "Asset not found"
}