Assets List

Retrieve a paginated list of all assets associated with the company.

GET

/api/v1/assets

Description

Retrieves a paginated list of all assets associated with the company. Each page contains up to 10 records by default. You can apply filters such as serialNumber and assetId to narrow down the results. Each asset object includes an AssignedUser object, which contains the name and email of the user to whom the device is assigned. If the device is unassigned, the AssignedUser object will be null.

Request

Query Parameters

Parameter	Type	Required	Description
page	number	No	Specifies the page number for pagination. Default is 1.
serialNumber	string	No	(Optional) Filters assets by serial number.
assetId	string	No	(Optional) Filters assets by ID.
asset_number	string	No	(Optional) Filters assets by number.

Related Endpoints

Asset Detail

Get detailed information about a specific asset

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?page=1 \
  -H "Authorization: Bearer <token>"

Success Response (200)

{
  "currentPage": 1,
  "totalPages": 53,
  "totalItems": 523,
  "assets": [
    {
      "asset_number": "106519700101000000",
      "assetId": "DEMO-ASSET-123",
      "modelName": "Core i7 10th Gen",
      "modelNumber": "Model X",
      "productType": "Laptop",
      "purchaseDate": "2024-01-01",
      "serialNumber": "SN123456",
      "sku": "SKU123",
      "assetStatus": "In Use",
      "AssignedUser": {
        "firstname": "John",
        "lastname": "Doe",
        "email": "john.doe@example.com"
      }
    },
    {
      "asset_number": "116519700101000000",
      "assetId": "DEMO-ASSET-456",
      "modelName": "Samsung Galaxy Tab A8",
      "modelNumber": "Model Y",
      "productType": "Tablet",
      "purchaseDate": "2024-02-01",
      "serialNumber": "SN654321",
      "sku": "SKU456",
      "assetStatus": "In Use",
      "AssignedUser": {
        "firstname": "Jane",
        "lastname": "Smith",
        "email": "jane.smith@example.com"
      }
    }
  ]
}

Error Responses

400 Bad Request

{
  "message": "Invalid page number"
}

401 Unauthorized

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

403 Forbidden

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