Asset List
Get a paginated list of all assets in your company.
GET
/api/v1/assetsDescription
Returns your company's assets with status, assignment, purchase, warranty, and asset details.
Filter by serial number, customer asset ID, or asset number. AssignedUser is included when the asset is assigned to an employee; otherwise it is null.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number (1-based). Default is 1. |
| limit | number | No | Records per page. Default is 10. Max 100 on tickets, wallet, and shipping labels. |
| limit | number | No | Records per page. Default 50, max 100. |
| serialNumber | string | No | Filter by serial number. |
| assetId | string | No | Filter by customer asset ID. |
| asset_number | string | No | Filter by generated asset number. |
Response
| Field | Type | Description |
|---|---|---|
| currentPage | number | Current page number. |
| totalPages | number | Total pages. |
| totalItems | number | Total matching assets. |
| assets | array | Asset records. |
| assets[].asset_number | string | Generated unique asset number. |
| assets[].assetId | string | Customer asset ID. |
| assets[].serialNumber | string | Asset serial number. |
| assets[].modelName | string | Product/model name. |
| assets[].modelNumber | string | Manufacturer model number. |
| assets[].productType | string | Product type name. |
| assets[].manufacturer | string | Manufacturer name. |
| assets[].assetStatus | string | Current status name. |
| assets[].condition | string | Asset condition. |
| assets[].sku | string | Asset SKU. |
| assets[].purchaseDate | string | Purchase date. |
| assets[].purchase_cost | number | Acquisition cost. |
| assets[].department | string | Department name. |
| assets[].location_name | string | Location name. |
| assets[].vendor | string | Vendor name. |
| assets[].description | string | Asset notes. |
| assets[].end_of_life | string | End-of-life date. |
| assets[].warranty_start | string | Warranty start date. |
| assets[].warranty_expire | string | Warranty expiry date. |
| assets[].warranty_type | string | Manufacturer or Extended. |
| assets[].processor_name | string | CPU / processor. |
| assets[].memory | string | RAM. |
| assets[].storage | string | Storage capacity. |
| assets[].os | string | Operating system. |
| assets[].imei | string | Primary IMEI. |
| assets[].imei2 | string | Secondary IMEI. |
| assets[].mac_address | string | MAC address. |
| assets[].ip_address | string | IP address. |
| assets[].encryption | string | Encryption status. |
| assets[].antivirus | string | Installed or Not Installed. |
| assets[].mdm_status | string | MDM enrollment status. |
| assets[].screen_size | string | Display size (monitors). |
| assets[].resolution | string | Screen resolution. |
| assets[].aspect_ratio | string | Aspect ratio. |
| assets[].print_resolution | string | Print resolution. |
| assets[].printer_type | string | Printer type. |
| assets[].AssignedUser | object | null | Assignee firstname, lastname, username, email; null when unassigned. |
| assets[].AssignedUser.firstname | string | Assignee first name. |
| assets[].AssignedUser.lastname | string | Assignee last name. |
| assets[].AssignedUser.username | string | Full name display. |
| assets[].AssignedUser.email | string | Assignee work email. |
Related Endpoints
Did this page help you?
Request
curl -X GET https://uat.unduit.com/api-exposed/api/v1/assets?page=1&limit=50 \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"Success Response
{
"currentPage": 1,
"totalPages": 11,
"totalItems": 523,
"assets": [
{
"asset_number": "2454620250602044825",
"assetId": "IT-1234-ABCD",
"modelName": "MacBook Pro 14",
"modelNumber": "A2338",
"productType": "Laptop",
"manufacturer": "Apple",
"purchaseDate": "2023-01-15",
"purchase_cost": 1999.99,
"serialNumber": "C02XK1ABCDEF",
"imei": "",
"imei2": "",
"sku": "MBP-16-2021",
"condition": "Good",
"assetStatus": "In Use",
"department": "IT",
"location_name": "Headquarters",
"vendor": "CDW",
"description": "Engineering team laptop",
"end_of_life": "",
"warranty_start": "2023-01-15",
"warranty_expire": "2025-01-14",
"warranty_type": "Manufacturer",
"processor_name": "Apple M3 Pro",
"memory": "16 GB",
"storage": "512 GB SSD",
"os": "macOS 14",
"mac_address": "00:1A:2B:3C:4D:5E",
"ip_address": "192.168.1.42",
"encryption": "FileVault",
"antivirus": "Installed",
"mdm_status": "",
"screen_size": "",
"resolution": "",
"aspect_ratio": "",
"print_resolution": "",
"printer_type": "",
"AssignedUser": {
"firstname": "John",
"lastname": "Doe",
"username": "John Doe",
"email": "john.doe@example.com"
}
}
]
}