API Changelog

Since the Smart Net Total Care (SNTC) portal is being decommissioned, the Services API is also being deprecated. Existing SNTC customers can continue regular operations by migrating to CX Cloud and using the CX Cloud API.

To migrate from the Services API to the CX Cloud API, update your applications to use the new base URL: https://apix.cisco.com/cs/api/v2/. The API path structure remains the same, but the version number in the base URL changes from v1 to v2, reflecting the transition from the deprecated Services API to the new CX Cloud API.

v2.0.0 - 2025-08-27

Initial release of the CX Cloud API.

Removed

This release does not support the following Services API operations:

[Collections]

• POST /collections/import-inventory
• POST /collections/import-inventory-file
• GET /collections/import-inventory-status

[Customer Info]

• GET /customer-info/inventory-groups

[Inventory]

• GET /inventory/software

Breaking Changes

This release does not support the Services API request parameters for the following operations:

[Inventory]

• GET /inventory/hardware: inventoryName, snapshot
• GET /inventory/network-elements: inventoryName, neType, sysName, snapshot, timeRangeStart, timeRangeEnd

[Contracts]

• GET /contracts/contract-details: billtoGuid, inventoryName, snapshot
• GET /contracts/coverage: billtoGuid, inventoryName, snapshot
• GET /contracts/not-covered: inventoryName, contractInstanceNumber, snapshot

[Product Alerts]

• GET /product-alerts/field-notices: inventoryName, snapshot, timeRangeStart, timeRangeEnd
• GET /product-alerts/hardware-eol-bulletins: startCreateDate, endCreateDate
• GET /product-alerts/hardware-eol: inventoryName, snapshot, timeRangeStart, timeRangeEnd
• GET /product-alerts/security-advisories: inventoryName, snapshot, timeRangeStart, timeRangeEnd
• GET /product-alerts/software-eol-bulletins: swMajorVersion, swTrain
• GET /product-alerts/software-eol: inventoryName, snapshot, timeRangeStart, timeRangeEnd

This release does not support the Services API response parameters for the following operations. These parameters will return null values to avoid breaking changes.

[Customer Info]

• GET /customer-info/customer-details: streetAddress1, streetAddress2, streetAddress3, streetAddress4, city, state, country, zipCode

[Inventory]

• GET /inventory/hardware: inventoryName, hwName, slot, serialNumberStatus, hwRevision, tan, tanRevision, pcbNumber, installedMemory, installedFlash, dimensionsFormat, dimensions, weight, formFactor, supportPage, visioStencilUrl, smallImageUrl, largeImageUrl, baseProductId, productReleaseDate
• GET /inventory/network-elements: inventoryName, neSubtype, inventoryAvailability, lastConfigRegister, sysName, featureSet, reachabilityStatus, lastReset, resetReason, sysContact, sysDescr, sysLocation, sysObjectId, configRegister, configAvailability, configCollectionDate, imageName, bootstrapVersion, userField1, userField2, userField3, userField4, macAddress

[Contracts]

• GET /contracts/contract-details: billtoSiteId, billtoSiteName, billtoAddressLine1, billtoAddressLine2, billtoAddressLine3, billtoAddressLine4, billtoCity, billtoState, billtoPostalCode, billtoProvince, billtoCountry, billtoGuName, billtoGuid, siteUseName, siteUseId, siteAddress1, siteCity, siteStateProvince, sitePostalCode, siteCountry, baseProductId
• GET /contracts/coverage: orderShipDate, serviceable, slaType, shiptoSiteId, shiptoSiteName, shiptoAddressLine1, shiptoAddressLine2, shiptoAddressLine3, shiptoAddressLine4, shiptoCity, shiptoState, shiptoPostalCode, shiptoProvince, shiptoCountry, installedatAddressLine3, installedatAddressLine4, billtoAddressLine3, billtoAddressLine4, billtoGuid, serviceLineId, lineCustomerName, ISPartner, APINAME
• GET /contracts/not-covered: orderShipDate, installedatAddressLine3, installedatAddressLine4, billtoGuId

[Product Alerts]

• GET /product-alerts/field-notice-bulletins: fieldNoticeType
• GET /product-alerts/security-advisories: hwInstanceId
• GET /product-alerts/software-eol-bulletins: swMajorVersion, swMaintenanceVersion, swTrain, swType