List Hardware EOL Bulletins - CX Cloud API

{"type":"api","title":"List Hardware EOL Bulletins","meta":{"id":"/apps/pubhub/media/cx-cloud-apis/987ccbfd309f978191d5f9ff79fe93a2865583d0/cbe9e4eb-3b67-3d77-bde8-9a8275c07620","info":{"title":"CX Cloud API","version":"2.0.0","description":"APIs to access CX Cloud data","contact":{"name":"CX Cloud Community","url":"https://community.cisco.com/t5/cx-cloud/bd-p/CX-Cloud-Discussions"},"license":{"name":"Cisco API License","url":"https://developer.cisco.com/site/license/cisco-api-license/"},"termsOfService":"https://www.cisco.com/c/dam/en_us/about/doing_business/legal/seula/cx-cloud-seula.pdf"},"security":[{"Oauth2":["apis:read"]}],"tags":[{"name":"customer","description":"API operations to get customer details from entitled CX Cloud accounts"},{"name":"inventory","description":"API operations to get inventory details from entitled CX Cloud accounts"},{"name":"contract","description":"API operations to get contract details from entitled CX Cloud accounts"},{"name":"productAlert","description":"API operations to get alerts details from entitled CX Cloud accounts"}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview.md"}},"openapi":"3.0.1","servers":[{"url":"https://apix.cisco.com/cs/api/v2","description":"Cisco API Console"}],"securitySchemes":{"Oauth2":{"type":"oauth2","description":"OAuth2 authentication with authorization code flow.","flows":{"authorizationCode":{"authorizationUrl":"https://id.cisco.com/oauth2/default/v1/token","tokenUrl":"https://id.cisco.com/oauth2/default/v1/token","scopes":{"apis:read":"Grants read access"}}}}}},"spec":{"summary":"List Hardware EOL Bulletins","operationId":"getHardwareEOLBulletins","description":"Returns End of Life bulletin data for the bulletins in the hardware-eol API.","tags":["productAlert"],"parameters":[{"name":"customerId","in":"query","required":true,"description":"A CX Cloud customer identifier","schema":{"type":"string","example":"abc123def"},"$$ref":"#/components/parameters/customerId_param"},{"name":"bulletinNumber","in":"query","description":"Unique identifier for a bulletin on Cisco.com","schema":{"type":"string","example":"EOL15177"},"$$ref":"#/components/parameters/bulletinNumber_param"},{"name":"bulletinProductId","in":"query","description":"Cisco Product ID on a published EOL bulletin","schema":{"type":"string","example":"WS-C6509-E"},"$$ref":"#/components/parameters/bulletinProductId_param"},{"name":"bulletinTitle","in":"query","description":"Cisco.com Title/Headline for the bulletin","schema":{"type":"string","example":"DNA Center Second Generation Appliance"},"$$ref":"#/components/parameters/bulletinTitle_param"},{"name":"eoLifeAnnouncementDate","in":"query","description":"Date when the bulletin was first published to Cisco.com","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoLifeAnnouncementDate_param"},{"name":"eoSaleDate","in":"query","description":"Last date to order the product through Cisco point-of-sale mechanisms. The product is no longer for sale after this date.","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoSaleDate_param"},{"name":"hwEolInstanceId","in":"query","description":"Unique identifier for hardware end-of-life entry in a data store","schema":{"type":"string","example":"234"},"$$ref":"#/components/parameters/hwEolInstanceId_param"},{"name":"lastShipDate","in":"query","description":"Last possible ship date that can be requested of Cisco and its contract manufacturers. Actual ship date depends on lead time.","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/lastShipDate_param"},{"name":"eoSwMaintenanceReleasesDate","in":"query","description":"Last date that Cisco engineering may release any final software maintenance releases or bug fixes. After this date, Cisco engineering will no longer develop, repair, maintain, or test the product software.","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoSwMaintenanceReleasesDate_param"},{"name":"eoRoutineFailureAnalysisDate","in":"query","description":"Last possible date a routine failure analysis may be performed to determine the cause of hardware product failure or defect","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoRoutineFailureAnalysisDate_param"},{"name":"eoNewServiceAttachmentDate","in":"query","description":"Last date to order a new service and support contract or add the equipment and software to an existing service-and-support contract","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoNewServiceAttachmentDate_param"},{"name":"eoServiceContractRenewalDate","in":"query","description":"Last date to extend or renew a service contract for the product","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoServiceContractRenewalDate_param"},{"name":"lastDateOfSupport","in":"query","description":"Last date to receive applicable service and support for the product as entitled by active service contracts or by warranty terms and conditions. After this date, all support services for the product will be unavailable and the product becomes obsolete.","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/lastDateOfSupport_param"},{"name":"eoVulnerabilitySecuritySupport","in":"query","description":"Last date that Cisco engineering may release a planned maintenance release or scheduled software remedy for a security vulnerability issue.","schema":{"type":"string","example":"2024-11-11"},"$$ref":"#/components/parameters/eoVulnerabilitySecuritySupport_param"},{"name":"format","in":"query","description":"Output format of the API response","schema":{"type":"string","default":"JSON","enum":["JSON","CSV","TSV"]},"$$ref":"#/components/parameters/format_param"},{"name":"fields","in":"query","description":"Restricts API response to the specific fields.","schema":{"type":"string","example":"field1,field2"},"$$ref":"#/components/parameters/fields_param"},{"name":"page","in":"query","description":"The page to return in a paginated API response.","schema":{"type":"integer","minimum":1,"default":1},"$$ref":"#/components/parameters/page_param"},{"name":"rows","in":"query","description":"The size of the page in the API response.","schema":{"type":"integer","default":20},"$$ref":"#/components/parameters/rows_param"},{"name":"sort","in":"query","description":"The sort order (ASC or DESC) for a field in the API response. Can be specified multiple times for multi-field sorting. If order is not specified for a field, it defaults to ASC. Example with multi-field sorting: sort=field&sort=field2:DESC","schema":{"type":"array","items":{"type":"string"}},"explode":true,"$$ref":"#/components/parameters/sort_param"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"description":"Hardware EOL Bulletins schema","type":"object","properties":{"data":{"description":"Contains array of Hardware EOL Bulletins","type":"array","items":{"properties":{"customerId":{"description":"A CX Cloud customer identifier.","type":"string","example":"abc123def"},"hwEolInstanceId":{"description":"The unique identifier for hardware bulletin","type":"string","example":"12345"},"bulletinProductId":{"description":"Cisco Product ID on a published EOL bulletin","type":"string","nullable":true,"example":"WS-C6509-E"},"bulletinNumber":{"description":"Unique identifier for a bulletin on Cisco.com","type":"string","nullable":true,"example":"EOL15177"},"bulletinTitle":{"description":"Cisco.com Title/Headline for the bulletin","type":"string","nullable":true,"example":"DNA Center Second Generation Appliance"},"eoLifeAnnouncementDate":{"description":"Date when the bulletin was first published to Cisco.com","type":"string","nullable":true,"example":"2024-11-11"},"eoNewServiceAttachmentDate":{"description":"Last date to order a new service and support contract or add the equipment and software to an existing service-and-support contract","type":"string","nullable":true,"example":"2024-11-11"},"eoRoutineFailureAnalysisDate":{"description":"Last possible date a routine failure analysis may be performed to determine the cause of hardware product failure or defect","type":"string","nullable":true,"example":"2024-11-11"},"eoSaleDate":{"description":"Last date to order the product through Cisco point-of-sale mechanisms. The product is no longer for sale after this date.","type":"string","nullable":true,"example":"2024-11-11"},"eoServiceContractRenewalDate":{"description":"Last date to extend or renew a service contract for the product","type":"string","nullable":true,"example":"2024-11-11"},"eoSwMaintenanceReleasesDate":{"description":"Last date that Cisco engineering may release any final software maintenance releases or bug fixes. After this date, Cisco engineering will no longer develop, repair, maintain, or test the product software.","type":"string","nullable":true,"example":"2024-11-11"},"eoVulnerabilitySecuritySupport":{"description":"Last date that Cisco engineering may release a planned maintenance release or scheduled software remedy for a security vulnerability issue.","type":"string","nullable":true,"example":"2024-11-11"},"lastDateOfSupport":{"description":"Last date to receive applicable service and support for the product as entitled by active service contracts or by warranty terms and conditions. After this date, all support services for the product will be unavailable and the product becomes obsolete. GMT date format YYYY-MM-DD","type":"string","nullable":true,"example":"2024-11-11"},"lastShipDate":{"description":"Last possible ship date that can be requested of Cisco and its contract manufacturers. Actual ship date depends on lead time.","type":"string","nullable":true,"example":"2024-11-11"},"url":{"description":"Uniform resource locator. The Cisco.com URL for the bulletin","type":"string","nullable":true,"example":"http://www.cisco.com"}}}},"pagination":{"description":"Pagination details","type":"object","properties":{"page":{"description":"Current page","type":"integer","format":"int32","example":1},"pages":{"description":"Total number of pages","type":"integer","format":"int32","example":3},"rows":{"description":"Number of records on each page","type":"integer","format":"int32","example":20},"total":{"description":"Total number of records","type":"integer","format":"int64","example":56}},"$$ref":"#/components/schemas/Pagination"}},"$$ref":"#/components/schemas/HardwareEolBulletins"}}},"headers":{"Cache-Control":{"description":"Cache Control Header","schema":{"type":"string"},"example":"no-cache","$$ref":"#/components/headers/CacheControl"},"TrackingID":{"description":"Tracking ID","schema":{"type":"string"},"example":"1234","$$ref":"#/components/headers/TrackingID"},"Date":{"description":"Timestamp the response was processed","schema":{"type":"string","format":"E, dd MMM yyyy HH:mm:ss z"},"example":"Fri, 27 Jun 2025 09:07:36 GMT","$$ref":"#/components/headers/Date"}},"$$ref":"#/components/responses/HardwareEolBulletinsResponse"},"400":{"description":"Bad Request","$$ref":"#/components/responses/BadRequestResponse"},"401":{"description":"Unauthorized","$$ref":"#/components/responses/UnauthorizedResponse"},"403":{"description":"Forbidden","$$ref":"#/components/responses/ForbiddenResponse"},"404":{"description":"Not Found","$$ref":"#/components/responses/NotFoundResponse"},"500":{"description":"Internal Server Error","$$ref":"#/components/responses/InternalServerErrorResponse"}},"security":[{"Oauth2":["apis:read"]}],"__originalOperationId":"getHardwareEOLBulletins","method":"get","path":"/product-alerts/hardware-eol-bulletins"}}