Skip to main content
Manage billing and payments using the billing command. View account balance, billing history, invoices, and configure auto-recharge.

​
Command Syntax

hopx billing <subcommand> [options]

​
Subcommands

​
balance

View account balance. Syntax: 
hopx billing balance [OPTIONS]
Examples: 
# View balance
hopx billing balance
Expected Output: 
┌─────────────┬─────────────────────────────────────┐
│ Property    │ Value                               │
├─────────────┼─────────────────────────────────────┤
│ Balance     │ $150.00                             │
│ Credits     │ 1500                                │
│ Currency    │ USD                                 │
└─────────────┴─────────────────────────────────────┘
Exit Codes:
  • 0 - Success
  • 3 - Authentication error

​
history

View billing history. Syntax: 
hopx billing history [OPTIONS]
Options:
  • --limit INTEGER - Number of records to show
  • --output, -o FORMAT - Output format: table, json, plain (default: table)
Examples: 
# View billing history
hopx billing history

# View with limit
hopx billing history --limit 10
Expected Output: 
┌──────────────┬──────────────┬─────────────┐
│ Date         │ Amount      │ Description │
├──────────────┼──────────────┼─────────────┤
│ 2025-01-27   │ $50.00      │ Payment     │
│ 2025-01-20   │ -$10.00     │ Usage       │
└──────────────┴──────────────┴─────────────┘
Exit Codes:
  • 0 - Success
  • 3 - Authentication error

​
invoices

List invoices. Syntax: 
hopx billing invoices [OPTIONS]
Options:
  • --limit INTEGER - Number of invoices to show
  • --output, -o FORMAT - Output format: table, json, plain (default: table)
Examples: 
# List invoices
hopx billing invoices

# List with limit
hopx billing invoices --limit 5
Expected Output: 
┌──────────────┬──────────────┬─────────────┐
│ Invoice ID   │ Date         │ Amount      │
├──────────────┼──────────────┼─────────────┤
│ inv_abc123   │ 2025-01-27   │ $50.00      │
│ inv_def456   │ 2025-01-20   │ $30.00      │
└──────────────┴──────────────┴─────────────┘
Exit Codes:
  • 0 - Success
  • 3 - Authentication error

​
auto-recharge

Configure auto-recharge settings. Syntax: 
hopx billing auto-recharge [OPTIONS]
Examples: 
# Configure auto-recharge
hopx billing auto-recharge
Expected Output: 
Auto-recharge configuration
✓ Auto-recharge enabled
Exit Codes:
  • 0 - Success
  • 3 - Authentication error

​
Next Steps