AudioCodes CLI
A CLI tool for troubleshooting VoIP on AudioCodes Mediant VE SBCs via the REST API. Query call statistics, monitor alarms, check device health, and manage device configurations.
AudioCodes REST API information can be found at:
AudioCodes REST API Reference.
Installation
npm install -g audiocodes-cli
Or run without installing:
npx audiocodes-cli --help
AI Agent Skills
npx skills add sieteunoseis/audiocodes-cli
Requirements
If you are using self-signed certificates on AudioCodes devices you may need to disable TLS verification, or use the --insecure CLI flag.
Tested with AudioCodes Mediant VE SBC firmware 7.40A.250.265 and 7.40A.600.203.
Quick Start
# Configure a device
audiocodes-cli config add lab-ve --host 10.0.0.50 --username Admin --password "$AUDIOCODES_PASSWORD" --insecure
# Test the connection
audiocodes-cli config test
# Check device health
audiocodes-cli doctor
# List active alarms
audiocodes-cli alarms list
# View call statistics
audiocodes-cli calls list
# Browse KPI metrics
audiocodes-cli kpi list
audiocodes-cli kpi show system/licenseStats/global
# Backup device config
audiocodes-cli device backup
Configuration
audiocodes-cli config add <name> --host <host> --username <user> --password <pass> --insecure
audiocodes-cli config use <name> # switch active device
audiocodes-cli config list # list all devices
audiocodes-cli config show # show active device (masks passwords)
audiocodes-cli config remove <name> # remove a device
audiocodes-cli config test # test connectivity
Auth precedence: CLI flags > env vars (AUDIOCODES_HOST, AUDIOCODES_USERNAME, AUDIOCODES_PASSWORD) > config file.
Config stored at ~/.audiocodes-cli/config.json. Supports ss-cli <ss:ID:field> placeholders.
The host field supports both https://hostname (default) and http://hostname for devices without TLS.
CLI Commands
| Command | Description |
|---|
calls list | View call statistics (global, per-IP-group, per-SRD) |
alarms list | List active alarms with optional severity filter |
alarms history | View alarm history |
kpi list | List available KPI categories |
kpi show <path> | Show real-time KPI metrics at a path |
kpi history <path> | Show historical KPI metrics (15-min intervals) |
device status | Show device status information |
device backup | Download device INI configuration |
device save | Save running config to NVRAM |
device license | Show license information |
device tls | Show TLS certificate status |
test-call dial | Start a SIP test call from the SBC |
test-call status <id> | Get test call status and results |
test-call show | Show test call configuration |
test-call drop <id> | End an active test call |
debug collect | Trigger and download debug file |
doctor | Check REST API connectivity and device health |
config add/use/list/show/remove/test | Manage device configurations |
Firmware Compatibility
Not all CLI commands are available on every firmware version. The table below shows command availability by firmware build:
