Cisco Support APIs

aid: cisco-support-apis
name: Cisco Support APIs
description: 'The Cisco Support APIs are the machine-readable side of Cisco''s TAC and lifecycle operations: EoX for end-of-life
  milestones, Serial Number to Information for entitlement and coverage, Product Information, Software Suggestion, Bug, Case,
  Automated Software Distribution, and Service Order Return. They are the APIs that let an enterprise reconcile its Cisco
  estate against support status programmatically, and are documented on Cisco DevNet behind a Smart Net Total Care or partner
  entitlement.'
url: https://raw.githubusercontent.com/api-evangelist/cisco-support-apis/refs/heads/main/apis.yml
type: Index
access: 3rd-Party
position: Consumer
x-type: company
x-source: cisco-family-buildout:2026-08-19
x-parent: cisco
x-relationship: product
x-contract-status: gated
x-contract-note: The Cisco Support APIs require a Smart Net Total Care or partner entitlement; no anonymously fetchable contract
  is served. API Evangelist has not authored a substitute.
specificationVersion: '0.23'
created: '2026-08-19'
modified: '2026-08-19'
tags:
- Support
- Lifecycle
- Asset Management
- Entitlement
- Enterprise
- Networking
- End of Life
- Defects
- Case Management
- Software Distribution
- RMA
- Smart Net Total Care
apis:
- aid: cisco-support-apis:cisco-eox-api
  name: Cisco EoX API
  description: The EoX API returns Cisco end-of-life and end-of-support milestones for hardware and software, queried by product
    ID, serial number, software release string, or a date range across all products. It is the machine-readable form of the
    Cisco End-of-Life bulletins, and the API an enterprise uses to reconcile an installed base against Cisco's lifecycle calendar.
    Batches are capped at 20 identifiers per request and the page index is a path segment rather than a query parameter.
  humanURL: https://developer.cisco.com/docs/support-apis/eox/
  baseURL: https://apix.cisco.com/supporttools/eox/rest/5
  tags:
  - Lifecycle
  - End of Life
  - Asset Management
  - Networking
  - Support
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/eox/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/eox/
- aid: cisco-support-apis:cisco-serial-number-to-information-api
  name: Cisco Serial Number to Information API
  description: 'The Serial Number to Information (SN2INFO) API translates Cisco device serial numbers and instance numbers
    into entitlement facts: coverage status, coverage summary with contract and warranty dates, orderable product identifier,
    and whether the requesting user is the covered owner. It is the entitlement lookup behind most Smart Net Total Care reconciliation
    work, and the first call in almost every Cisco support automation.'
  humanURL: https://developer.cisco.com/docs/support-apis/serial-number-to-information/
  baseURL: https://apix.cisco.com/sn2info/v2
  tags:
  - Entitlement
  - Asset Management
  - Support
  - Warranty
  - Networking
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/serial-number-to-information/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/serial-number-to-information/
- aid: cisco-support-apis:cisco-product-information-api
  name: Cisco Product Information API
  description: 'The Product Information API returns Cisco product attributes for a set of serial numbers or product identifiers,
    including the MDF product-hierarchy identifiers that the Software Suggestion and Bug APIs consume. It is the joining table
    of the Support API portfolio: the service that turns a serial number found on a device into the identifiers the rest of
    the APIs accept. Responses page at 500 records.'
  humanURL: https://developer.cisco.com/docs/support-apis/product-information/
  baseURL: https://apix.cisco.com/product/v1
  tags:
  - Product Data
  - Asset Management
  - Support
  - Networking
  - Reference Data
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/product-information/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/product-information/
- aid: cisco-support-apis:cisco-software-suggestion-api
  name: Cisco Software Suggestion API
  description: The Software Suggestion API returns the software release Cisco recommends for a product, chosen on stability,
    longevity and adoption rate, along with the available images and compatibility against a currently-installed release.
    It answers the question every network operations team asks before a maintenance window — what should this device be running
    — for up to ten product IDs or MDF IDs at a time.
  humanURL: https://developer.cisco.com/docs/support-apis/software-suggestion/
  baseURL: https://apix.cisco.com/software/suggestion/v2
  tags:
  - Software Lifecycle
  - Upgrades
  - Support
  - Networking
  - Recommendations
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/software-suggestion/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/software-suggestion/
- aid: cisco-support-apis:cisco-bug-api
  name: Cisco Bug API
  description: 'The Bug API exposes the Cisco defect database: lookup by bug ID, by base product ID with or without a software
    release, by product series or product name against affected or fixed-in releases, and free-text keyword search. It is
    how an operator finds out whether a symptom in production is a known Cisco defect, and whether a candidate upgrade release
    fixes it, without opening a TAC case first.'
  humanURL: https://developer.cisco.com/docs/support-apis/bug/
  baseURL: https://apix.cisco.com/bug/v2.0
  tags:
  - Defects
  - Support
  - Search
  - Networking
  tags_raw:
  - Defects
  - Support
  - Search
  - Networking
  - Operations
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/bug/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/bug/
- aid: cisco-support-apis:cisco-case-api
  name: Cisco Case API
  description: The Case API returns Cisco TAC support case information — a summary or full detail for specific case IDs, or
    an aggregate view of cases by contract ID or by up to ten Cisco.com user IDs within a date range. It is how a customer
    or partner pulls their TAC case load into their own ticketing or reporting system instead of working out of Support Case
    Manager.
  humanURL: https://developer.cisco.com/docs/support-apis/case/
  baseURL: https://apix.cisco.com/case/v3
  tags:
  - Support
  - Ticketing
  - Case Management
  - Enterprise
  tags_raw:
  - Support
  - Ticketing
  - Case Management
  - Operations
  - Enterprise
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/case/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/case/
- aid: cisco-support-apis:cisco-automated-software-distribution-api
  name: Cisco Automated Software Distribution API
  description: 'The Automated Software Distribution API provides software release and image metadata for a device, MD5 checksums,
    and signed download URLs, and it electronically signs the K9 cryptographic-software and End User License agreements required
    before a download. It is the only write surface in the Support API portfolio: every operation is a POST, two of them execute
    legal agreements, and none has a documented idempotency mechanism.'
  humanURL: https://developer.cisco.com/docs/support-apis/automated-software-distribution/
  baseURL: https://apix.cisco.com/software/v4.0
  tags:
  - Software Distribution
  - Downloads
  - Compliance
  - Support
  - Networking
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/automated-software-distribution/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/automated-software-distribution/
- aid: cisco-support-apis:cisco-service-order-return-api
  name: Cisco Service Order Return (RMA) API
  description: The Service Order Return API returns Return Material Authorization (RMA) information — detail for a specific
    RMA number, or every RMA raised by a Cisco.com user within a date range. It is the machine-readable side of the Service
    Order RMA Tool, used to track hardware replacement flowing out of a support contract without polling a web UI.
  humanURL: https://developer.cisco.com/docs/support-apis/service-order-return-rma/
  baseURL: https://apix.cisco.com/return/v1.0
  tags:
  - RMA
  - Returns
  - Logistics
  - Support
  - Enterprise
  properties:
  - type: Documentation
    url: https://developer.cisco.com/docs/support-apis/service-order-return-rma/
  - type: APIReference
    url: https://developer.cisco.com/docs/support-apis/service-order-return-rma/
common:
- type: VulnerabilityDisclosure
  url: security/cisco-support-apis-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/cisco-support-apis-domain-security.yml
- type: ParentCompany
  url: https://apis.io/providers/cisco/
  name: Cisco
  x-relationship: product
  x-generated-by: cisco-family:2026-08-19
- type: Documentation
  url: https://developer.cisco.com/docs/support-apis/
- type: APIReference
  url: https://developer.cisco.com/docs/support-apis/
- type: Portal
  url: https://developer.cisco.com/site/support-apis/
  name: Cisco Support APIs developer site
- type: GettingStarted
  url: https://developer.cisco.com/docs/support-apis/user-onboarding-process/
  name: User onboarding process
- type: Support
  url: https://developer.cisco.com/docs/support-apis/developer-support/
  name: Developer Support
- type: GitHubOrganization
  url: https://github.com/CiscoDevNet
- type: Login
  url: https://apiconsole.cisco.com/
  name: Cisco API Console — register an application and obtain credentials
- type: TermsOfService
  url: https://www.cisco.com/c/en/us/about/legal/terms-conditions.html
- type: PrivacyPolicy
  url: https://www.cisco.com/c/en/us/about/legal/privacy-full.html
- type: StatusPage
  url: https://status.cisco.com/
- type: ChangeLog
  url: https://developer.cisco.com/docs/support-apis/api-changelog/
  x-note: Published, but contains zero entries as of 2026-08-19 — see changelog/cisco-support-apis-changelog.yml
- type: Postman
  url: https://github.com/CiscoDevNet/Cisco_Support_API_Postman
  name: Support APIs - DevNet (first-party Postman collection)
- type: TrustCenter
  url: https://trustportal.cisco.com/c/r/ctp/trust-portal.html
- type: Security
  url: security/cisco-support-apis-vulnerability-disclosure.yml
  name: Cisco PSIRT vulnerability disclosure policy
- type: WellKnown
  url: well-known/cisco-support-apis-well-known.yml
- type: SecurityTxt
  url: well-known/cisco-support-apis-security.txt
- type: Authentication
  url: authentication/cisco-support-apis-authentication.yml
- type: ErrorCatalog
  url: errors/cisco-support-apis-problem-types.yml
- type: Conventions
  url: conventions/cisco-support-apis-conventions.yml
- type: RateLimits
  url: rate-limits/cisco-support-apis-rate-limits.yml
- type: Plans
  url: plans/cisco-support-apis-plans-pricing.yml
- type: ChangeLog
  url: changelog/cisco-support-apis-changelog.yml
- type: Lifecycle
  url: lifecycle/cisco-support-apis-lifecycle.yml
- type: Packages
  url: packages/cisco-support-apis-packages.yml
- type: Conformance
  url: conformance/cisco-support-apis-conformance.yml
- type: DataModel
  url: data-model/cisco-support-apis-data-model.yml
- type: LLMsTxt
  url: llms/cisco-support-apis-llms.txt
- type: PostmanCollection
  url: postman/cisco-support-apis-postman.yml
- type: x-ContractAvailability
  url: contracts/cisco-support-apis-published-contracts.yml
  name: Published but credential-gated WADL + Swagger contracts
- type: x-SandboxAbsence
  url: sandbox/cisco-support-apis-sandbox.yml
  name: No sandbox published; the only try-it console is behind the API Console sign-in (403).
- type: x-TrustCenterProbe
  url: security/cisco-support-apis-trust-center.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/cisco.png
x-enrichment:
  date: '2026-08-19'
  status: enriched
  artifacts_added: 23
  pass: local-v1