cisco-support

CLI for querying Cisco Support APIs — bugs, cases, end-of-life, security advisories, product info, software suggestions, serial coverage/warranty, and RMA tracking.

Prerequisites

You need API credentials from Cisco API Console:

1. Sign in with your Cisco CCO account
2. Register an application
3. Enable the APIs you need (Bug, Case, EoX, PSIRT, Product, Software, Serial, RMA)
4. Note your Client ID and Client Secret

Installation

npm install -g cisco-support

Quick Start

# Configure credentials
cisco-support config add --client-id <your-id> --client-secret <your-secret>

# Or with Secret Server
cisco-support config add --client-id '<ss:22001:client-id>' --client-secret '<ss:22001:client-secret>'

# Verify
cisco-support doctor

# Start querying
cisco-support bug search --keyword "memory leak"
cisco-support psirt latest --count 5
cisco-support eox --pid WS-C3850-24T

Commands

Bug Search & Lookup

cisco-support bug get CSCvx12345
cisco-support bug get CSCvx12345,CSCvx67890
cisco-support bug search --keyword "crash"
cisco-support bug search --pid CSR1000V --release 17.3
cisco-support bug search --keyword "voice" --severity 1,2 --status open
cisco-support bug search --keyword "onemedia" --progressive

Support Cases

cisco-support case get 123456789
cisco-support case search --contract 12345
cisco-support case search --user userID123

End-of-Life (EoX)

cisco-support eox --pid WS-C3850-24T
cisco-support eox --serial FJC12345678
cisco-support eox --software "15.0(2)SE"
cisco-support eox --date-range 2026-01-01 2026-06-30

Security Advisories (PSIRT)

cisco-support psirt latest --count 10
cisco-support psirt get cisco-sa-20260101-example
cisco-support psirt --cve CVE-2026-1234
cisco-support psirt --severity critical
cisco-support psirt --year 2026

Product Information

cisco-support product --serial FJC12345678
cisco-support product --pid WS-C3850-24T

Software Suggestions

cisco-support software suggest --pid WS-C3850-24T
cisco-support software releases --pid WS-C3850-24T
cisco-support software compare --pid WS-C3850-24T --from 16.9 --to 17.3

Serial Coverage & Warranty

cisco-support serial coverage FJC12345678
cisco-support serial warranty FJC12345678

RMA Tracking

cisco-support rma get 12345678
cisco-support rma --serial FJC12345678

Configuration & Health

cisco-support config show
cisco-support config test
cisco-support config enable-api bug,psirt
cisco-support doctor

Output Formats

All commands support --format table|json|toon|csv:

cisco-support bug search --keyword "crash" --format json
cisco-support eox --pid WS-C3850-24T --format csv > eox-report.csv

Environment Variables

| Variable | Description | |---|---| | CISCO_CLIENT_ID | Cisco API client ID (overrides config) | | CISCO_CLIENT_SECRET | Cisco API client secret (overrides config) |

Related Tools

| Tool | Purpose | |---|---| | cisco-axl | CUCM configuration via AXL | | cisco-dime | CUCM log collection via DIME | | cisco-ise | ISE endpoint & session management | | cisco-uc-engineer | UC troubleshooting orchestration |

Funding

License

MIT