How to check billing status, service status, and network diagnostics for a UISP customer

Customer Status Check

Version: 1.0
Created: 2026-02-11

Status Check Commands

Comprehensive Status (Recommended)

cd /home/karetech/clawd
source scripts/load-secrets.sh
python3 skills/satlinkgy-uisp/scripts/uisp.py status "Customer Name" --whatsapp

What it shows:

Account and billing status
Overdue months calculation
Service status (CRM)
CPE status (NMS)
Network metrics (speeds, signal, AP)
WhatsApp-formatted output

When to use:

Daily status checks
Before reconnection
Customer inquiries about service
Verifying payment status

Device-Focused Check

python3 skills/satlinkgy-uisp/scripts/check_with_device.py "Customer Full Name"

Shows: account active/inactive, outstanding balance, CPE online/offline, device model.

Manual API Check

# Get client by name
GET /crm/api/v1.0/clients?name=<customer>
 
# Get services
GET /crm/api/v1.0/clients/{id}/services
 
# Get NMS device (CPE)
GET /nms/api/v2.1/devices/{id}

Service Status Codes

Code	Status	Meaning
1	Active	Service is live
2	Inactive	Manually deactivated
4	Terminated	Permanently ended
5	Suspended	Non-payment or manual
6	Quoted	Auto-created on device adoption
7	Obsolete	Old/deprecated service

Network Status Interpretation

Signal (dBm)	Quality
-50 to -65	Excellent
-66 to -75	Good
-76 to -85	Fair
below -85	Poor

CPE Offline Troubleshooting

Check NMS device status
Verify power at customer premises
Check if AP is online (parent device)
Ping device IP from VPN
If AP offline, check UISP Router WireGuard persistence (see Networking SOP)

Customer Status Check

On this page