POST Search an Asset

For Asset search there are basically 3 types of API divided for Hardware, Software and Non It Asset where, you can call the below endpoints to search any asset in the ServiceOps Solution.

1. Hardware Asset : 'http://{server_url}/api/v1/asset/asset_hardware/search/byqual?offset=0&size=50'
2. Software Asset : 'http://{server_url}/api/v1/asset/asset_software/search/byqual?offset=0&size=50'
3. Non IT Asset : 'http://{server_url}/api/v1/asset/asset_non_it/search/byqual?offset=0&size=50'

Header

Key	Description
Authorization	Bearer {access token obtained after authorization}/ API Key
Content-Type	application/json

Body

Key	Description
type	value

Here is an example of Search with IP Address on the Hardware asset:

Request

curl --location 'http://{server_url}/api/v1/asset/asset_hardware/search/byqual?offset=0&size=50' \
--header 'Accept: application/json' \
--header 'Authorization: Apikey A%2BOQbxnfowXUMRzE%40AGZYUp3dldMqjN81TD1EtwCCEKgtxzZewlOCRWHAQ97gIrjnXUMKJasJWyFusmc%3D' \
--header 'Content-Type: application/json' \
--data '{
    "fullObject": true,
    "qualDetails": {
        "type": "FlatQualificationRest",
        "quals": [
            {
                "type": "RelationalQualificationRest",
                "leftOperand": {
                    "type": "PropertyOperandRest",
                    "key": "asset_hardware.displayName"
                },
                "operator": "equal_case_insensitive",
                "rightOperand": {
                    "type": "ValueOperandRest",
                    "value": {
                        "type": "StringValueRest",
                        "value": "hardwareasset"
                    }
                }
            }
        ]
    }
}'

info

Here, fullObject field is used to return the custom fields of the asset in response.

Response

{
    "objectList": [
        {
            "id": 24,
            "assetTypeName": "Hardware",
            "assetId": "AST-21",
            "name": "hardwareasset",
            "description": "",
            "impactName": "Low",
            "statusName": "In Use",
            "origin": "manual",
            "tags": [],
            "customField": {
                "New Checkbox": [
                    "yes",
                    "no"
                ],
                "Custom Text Input": "hello test",
                "New Dropdown": "option-1",
                "New Number": 100.0,
                "New Radio": "true",
                "New Text Input": "testing",
                "New Rich Text Area": "<p>Testing is the systematic process of evaluating, examining, or measuring the quality, performance, and functionality of a product, system, or software against defined requirements. It ensures reliability, identifies defects (bugs), and verifies that actual outcomes align with expected results, commonly involving a mix of manual and automated techniques</p>"
            },
            "createdDate": "22/04/2026 06:21 pm",
            "updatedDate": "22/04/2026 06:48 pm",
            "assetPropertyList": [
                {
                    "id": 21,
                    "refName": "AST-21",
                    "type": "HardwareProperty",
                    "serialNumber": null,
                    "propertyCustomField": {
                        "New Text Area": "",
                        "New Text Input": ""
                    }
                }
            ],
            "fileAttachments": [
                {
                    "refFileName": "0727ec26-42f3-4346-810e-cffcf0e07ed3",
                    "realName": "custom_script_80223.pdf"
                }
            ],
            "createdByName": "jerry",
            "updatedByName": "jerry",
            "concreteModel": "asset_hardware"
        }
    ],
    "totalCount": 1
}