{"type":"api","title":"Device License Details","meta":{"id":"/apps/pubhub/media/cisco-catalyst-center-api-2-3-7-7/3b279f20e8e625c794c96f307ed82cded7945b01/4d9020fd-168f-35ec-acc2-076e9170d62e","info":{"title":"Intent API","description":"Cisco Catalyst Center Platform v. 2.3.7.7","version":"2.3.7.7"},"tags":[{"name":"Authentication","description":"Access Token Request"},{"name":"Sites","description":"Create sites, assign devices to them and get site health"},{"name":"Topology","description":"Get topology details and overall network health"},{"name":"Devices","description":"Manage network devices"},{"name":"Clients","description":"Get client (by MAC Address) health, status, and information"},{"name":"Users","description":"Obtain information about *Users* and associated connections and devices"},{"name":"Issues","description":"Obtain issue details, impacted hosts, and suggested actions for remediation"},{"name":"Site Design","description":"Design/provision NFV device to site/area/building/floor"},{"name":"Network Settings","description":"Manage Network Settings"},{"name":"Software Image Management (SWIM)","description":"Manage activation and distribution of software images"},{"name":"Device Onboarding (PnP)","description":"Zero-touch deployment of network devices"},{"name":"Configuration Templates","description":"Configure and manage CLI templates"},{"name":"Configuration Archive","description":"Export device configurations to an encrypted zip file"},{"name":"SDA","description":"(BETA) Configure and manage SDA wired fabric border devices"},{"name":"Sensors","description":"Manage sensor test templates"},{"name":"Wireless","description":"Configure and manage SSIDs, Wireless, and RF profiles in non-fabric wireless network"},{"name":"Command Runner","description":"Retrieve real-time device configuration and CLI keywords"},{"name":"Discovery","description":"Discover network devices and manage discovery jobs"},{"name":"Path Trace","description":"Network route and flow analysis"},{"name":"File","description":"Get configuration files by namespace and ID"},{"name":"Task","description":"Get information about asynchronous tasks"},{"name":"Tag","description":"Assign administrator-defined tags to network devices"},{"name":"Application Policy","description":"Create and manage applications, application sets, and application policies"},{"name":"Applications","description":"Intent API to get a list of applications for a specific site, a device, or a client device's MAC address"},{"name":"ITSM","description":"Provide the details of the various third party integrations that are supported"},{"name":"Event Management","description":"Event based notification to external handlers"},{"name":"Security Advisories","description":"Provides the details of advisories on the network and devices"},{"name":"Compliance","description":"Provides compliance status data on the devices"}],"x-parser-conf":{"expand":0,"labelConfig":{"endpoint":"summary"}},"openapi":"3.0.3","servers":[{"url":"/"}]},"spec":{"operationId":"deviceLicenseDetails","tags":["Licenses"],"summary":"Device License Details","deprecated":false,"description":"Get detailed license information of a device.","parameters":[{"name":"device_uuid","description":"Id of device","required":true,"schema":{"type":"string","default":"application/json"},"in":"path"}],"responses":{"200":{"description":"The request was successful. The result is contained in the response body.","content":{"application/json":{"schema":{"type":"object","properties":{"device_uuid":{"type":"string","description":"Id of device"},"site":{"type":"string","description":"Site of device"},"model":{"type":"string","description":"Model of device"},"license_mode":{"type":"string","description":"Mode of license"},"is_license_expired":{"type":"boolean","description":"Is device license expired"},"software_version":{"type":"string","description":"Software image version of device"},"network_license":{"type":"string","description":"Device network license level"},"evaluation_license_expiry":{"type":"string","description":"Evaluation period expiry date"},"device_name":{"type":"string","description":"Name of device"},"device_type":{"type":"string","description":"Type of device"},"dna_level":{"type":"string","description":"Device Cisco DNA license level"},"virtual_account_name":{"type":"string","description":"Name of virtual account"},"ip_address":{"type":"string","description":"IP address of device"},"mac_address":{"type":"string","description":"MAC address of device"},"sntc_status":{"type":"string","description":"Valid if device is covered under license contract and invalid if not covered, otherwise unknown."},"feature_license":{"type":"array","items":{"type":"string"},"description":"Name of feature licenses"},"has_sup_cards":{"type":"boolean","description":"Whether device has supervisor cards"},"udi":{"type":"string","description":"Unique Device Identifier"},"stacked_devices":{"type":"array","items":{"type":"object","properties":{"mac_address":{"type":"string","description":"Stack mac address"},"id":{"type":"integer","description":"Id"},"role":{"type":"string","description":"Chassis role"},"serial_number":{"type":"string","description":"Chassis serial number"}},"required":["mac_address","id","role","serial_number"]},"description":"Stacked device details"},"is_stacked_device":{"type":"boolean","description":"Is Stacked Device"},"access_points":{"type":"array","items":{"type":"object","properties":{"ap_type":{"type":"string","description":"Type of access point"},"count":{"type":"string","description":"Number of access point"}},"required":["ap_type","count"]},"description":"Access point details"},"chassis_details":{"type":"object","properties":{"board_serial_number":{"type":"string","description":"Board serial number"},"modules":{"type":"array","items":{"type":"object","properties":{"module_type":{"type":"string","description":"Type of module"},"module_name":{"type":"string","description":"Name of module"},"serial_number":{"type":"string","description":"Serial number of module"},"id":{"type":"integer","description":"Id of module"}},"required":["module_type","module_name","serial_number","id"]},"description":"Module details"},"supervisor_cards":{"type":"array","items":{"type":"object","properties":{"serial_number":{"type":"string","description":"Serial number of supervisor card"},"supervisor_card_type":{"type":"string","description":"Type of supervisor card"},"status":{"type":"string","description":"Status of supervisor card"}},"required":["serial_number","supervisor_card_type","status"]},"description":"Supervisor card details"},"port":{"type":"integer","description":"Number of port"}},"required":["board_serial_number","modules","supervisor_cards","port"],"description":"Chassis Details"}},"required":["device_uuid","site","model","license_mode","is_license_expired","software_version","network_license","evaluation_license_expiry","device_name","device_type","dna_level","virtual_account_name","ip_address","mac_address","sntc_status","feature_license","udi","stacked_devices","is_stacked_device","access_points","chassis_details"],"description":"","$$ref":"#/components/schemas/deviceLicenseDetailsResponse"}}}},"400":{"description":"The client made a request that the server could not understand (for example, the request syntax is incorrect).","content":{}},"401":{"description":"The client's authentication credentials included with the request are missing or invalid.","content":{}},"403":{"description":"The server recognizes the authentication credentials, but the client is not authorized to perform this request.","content":{}},"404":{"description":"The client made a request for a resource that does not exist.","content":{}},"500":{"description":"The server could not fulfill the request.","content":{}},"502":{"description":"The server is (temporarily) unavailable.","content":{}},"503":{"description":"The server is (temporarily) unavailable.","content":{}}},"x-rapi-id":"dca1-1bc2-4e7b-8c5d","x-rapi-overview":"Get detailed license information of a device.","x-rapi-domain":"Cisco DNA Center System","x-rapi-subdomain":"Licenses","x-rapi-version":"1.0.0","x-rapi-internalPath":"/api/v1/licensemanager/intent/device/${device_uuid}/details","x-rapi-publicPath":"/dna/intent/api/v1/licenses/device/${device_uuid}/details","x-rapi-registerInKONG":true,"x-rapi-banner":["Intent"],"x-rapi-deprecationMessage":null,"x-rapi-rateLimiting":"100~MINUTE","__originalOperationId":"deviceLicenseDetails","method":"get","path":"/dna/intent/api/v1/licenses/device/{device_uuid}/details"}}