{"type":"api","title":"Get Asset List","meta":{"id":"/apps/pubhub/media/cisco-cyber-vision-5-5-new-ui-api/97fd9edf2b6a0a8ec8ee3e0f165d61af50f7b6b7/262737b2-b3c2-32cd-b07b-fdbdcd23918f","swagger":"2.0","info":{"description":"API to manage the resources of Cisco Cyber Vision - New UI.","title":"Cisco Cyber Vision - New UI API.","contact":{"name":"Cisco Industrial Networking Community","url":"https://community.cisco.com/t5/industrial-networking/bd-p/discussions-iot-industrial-routing","email":"tac@cisco.com"},"license":{"name":"Cisco API License Terms and Conditions","url":"https://developer.cisco.com/site/license/cisco-api-license/"},"version":"1.0.0-5.5.0"},"basePath":"/cvapi/v1/","schemes":["https"],"securityDefinitions":{"token":{"description":"API token created in the Cyber Vision administration UI","type":"apiKey","name":"x-token-id","in":"header"}},"security":[{"token":[]}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview.md"}}},"spec":{"description":"Retrieves a list of assets based on the provided query parameters. Pagination is handled by a cursor, which is provided in the HTTP response header for fetching subsequent results.","tags":["Assets"],"summary":"Get a paginated list of assets","operationId":"getAssetList","parameters":[{"type":"integer","format":"int32","description":"Maximum number of assets to return in a single response.","name":"max","in":"query"},{"type":"string","description":"Cursor for pagination, obtained from a previous response to fetch the next set of assets.","name":"cursor","in":"query"},{"type":"string","description":"Filter assets by their last active time, specified as a duration (e.g., \"30d\" for 30 days ago).","name":"lastActiveTime","in":"query"},{"type":"string","description":"Filter assets by their first active time, specified as a duration (e.g., \"30d\" for 30 days ago).","name":"firstActiveTime","in":"query"},{"type":"boolean","description":"Filter assets based on their vulnerability status (true for vulnerable, false for not vulnerable).","name":"vulnerable","in":"query"},{"type":"boolean","description":"Filter assets that have active alerts (true) or do not (false).","name":"hasActiveAlerts","in":"query"},{"type":"string","description":"Filter assets by functional group name.","name":"functionalGroupName","in":"query"},{"type":"string","description":"Filter assets by vendor name.","name":"vendor","in":"query"},{"type":"string","description":"Filter assets by type.","name":"type","in":"query"},{"type":"string","description":"Filter assets by their name.","name":"name","in":"query"}],"responses":{"200":{"description":"Success","schema":{"type":"object","properties":{"centerId":{"type":"string","format":"uuid","x-go-name":"CenterID"},"items":{"type":"array","items":{"type":"object","properties":{"activeAlertCount":{"type":"integer","format":"int64","x-go-name":"ActiveAlertCount"},"creationTime":{"type":"string","format":"date-time","x-go-name":"CreationTime"},"customProperties":{"type":"array","items":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time","x-go-name":"CreatedAt"},"id":{"type":"string","format":"uuid","x-go-name":"ID"},"key":{"type":"string","x-go-name":"Key"},"networkId":{"type":"string","format":"uuid","x-go-name":"NetworkID"},"networkName":{"type":"string","x-go-name":"NetworkName"},"source":{"type":"string","x-go-name":"Source"},"updatedAt":{"type":"string","format":"date-time","x-go-name":"UpdatedAt"},"value":{"type":"string","x-go-name":"Value"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/AssetCustomPropertySummary"},"x-go-name":"CustomProperties"},"firstActiveTime":{"type":"string","format":"date-time","x-go-name":"FirstActiveTime"},"functionalGroupId":{"type":"string","format":"uuid","x-go-name":"FunctionalGroupId"},"functionalGroupName":{"type":"string","x-go-name":"FunctionalGroupName"},"id":{"type":"string","format":"uuid","x-go-name":"ID"},"lastActiveTime":{"type":"string","format":"date-time","x-go-name":"LastActiveTime"},"name":{"type":"string","x-go-name":"Name"},"networkInterfaces":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string","x-go-name":"IP"},"isPrimary":{"type":"boolean","x-go-name":"Primary"},"mac":{"type":"string","x-go-name":"MAC"},"networkName":{"type":"string","x-go-name":"NetworkName"},"vlan":{"type":"integer","format":"int64","x-go-name":"VLAN"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/AssetInterfaceSummary"},"x-go-name":"NetworkInterfaces"},"pcapAssociations":{"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","x-go-name":"Filename"},"id":{"type":"string","format":"uuid","x-go-name":"ID"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/AssetPcap"},"x-go-name":"PcapAssociations"},"sensorAssociations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","x-go-name":"ID"},"isClose":{"type":"boolean","x-go-name":"IsClose"},"label":{"type":"string","x-go-name":"Label"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/AssetSensor"},"x-go-name":"SensorAssociations"},"type":{"type":"string","x-go-name":"Type"},"vendor":{"type":"string","x-go-name":"Vendor"},"vulnerabilityCount":{"type":"integer","format":"int64","x-go-name":"VulnerabilityCount"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/Asset"},"x-go-name":"Items"},"pageSize":{"type":"integer","format":"int64","x-go-name":"PageSize"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/cmd/od-backend/api4/model","$$ref":"#/definitions/AssetListResponse"},"examples":{"application/json":{"centerId":"550e8400-e29b-41d4-a716-446655440000","items":[{"activeAlertCount":1,"creationTime":"2025-09-17T03:28:00.978789Z","firstActiveTime":"2025-09-17T03:27:46.507698Z","functionalGroupId":"00000000-0000-0000-0000-000000000000","functionalGroupName":"","id":"019955be-045a-723f-8d95-6412827e4586","lastActiveTime":"2025-09-17T03:27:46.544944Z","name":"Intel 10.11.255.73","networkInterfaces":[{"ip":"10.11.255.73","isPrimary":true,"mac":"70:1c:e7:5b:6e:77","networkName":"10/8 private network"},{"ip":"fe80::45:5d9b:4d96:cd91","isPrimary":false,"mac":"70:1c:e7:5b:6e:77","networkName":"IPv6 link local"}],"pcapAssociations":[],"sensorAssociations":[],"type":"IT Generic","vendor":"Intel","vulnerabilityCount":0}],"pageSize":1}}},"400":{"description":"Bad request"},"401":{"description":"incorrect token"},"404":{"description":"Not found"},"500":{"description":"internal server error"}},"__originalOperationId":"getAssetList","consumes":["application/json"],"produces":["application/json"],"security":[{"token":[]}],"method":"get","path":"/assets"}}