Spending Limits
Set and manage spending limits for your Audian account.
Overview​
Spending limits help you control costs and prevent unexpected charges. You can set limits on:
- Total monthly spending
- Per-feature costs (SMS, voice, etc.)
- Daily spending
- Overage protection
Set Monthly Spending Limit​
Configure a maximum monthly spending limit for your account.
Endpoint​
PUT https://api.audian.com:8443/v2/billing/limits/monthly
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | number | Yes | Maximum monthly amount in USD |
action | string | No | Action when limit reached (alert, block) |
notifications | array | No | Notification settings |
Request Example​
curl -X PUT 'https://api.audian.com:8443/v2/billing/limits/monthly' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"amount": 500.00,
"action": "alert",
"notifications": ["email", "sms"]
}'
Response​
{
"success": true,
"data": {
"type": "monthly",
"amount": 500.00,
"action": "alert",
"current_usage": 150.75,
"remaining": 349.25,
"percentage_used": 30.2,
"notifications": ["email", "sms"],
"created_at": "2024-01-15T10:30:00Z"
}
}
Get Spending Limits​
Retrieve all spending limits for your account.
Endpoint​
GET https://api.audian.com:8443/v2/billing/limits
Request Example​
curl -X GET 'https://api.audian.com:8443/v2/billing/limits' \
-H 'X-Auth-Token: YOUR_API_KEY'
Response​
{
"success": true,
"data": {
"limits": [
{
"id": "limit_abc123",
"type": "monthly",
"amount": 500.00,
"action": "alert",
"current_usage": 150.75,
"remaining": 349.25,
"percentage_used": 30.2,
"status": "active"
},
{
"id": "limit_abc124",
"type": "daily",
"amount": 25.00,
"action": "block",
"current_usage": 12.50,
"remaining": 12.50,
"percentage_used": 50.0,
"status": "active"
},
{
"id": "limit_abc125",
"type": "sms",
"amount": 100.00,
"action": "alert",
"current_usage": 45.60,
"remaining": 54.40,
"percentage_used": 45.6,
"status": "active"
}
]
}
}
Limit Types​
Monthly Limit​
Caps your total spending for the calendar month.
{
"type": "monthly",
"amount": 500.00,
"action": "alert"
}
Daily Limit​
Caps your spending for each 24-hour period.
{
"type": "daily",
"amount": 25.00,
"action": "block"
}
Per-Feature Limits​
Set limits on specific features:
- SMS: Limit on SMS messaging costs
- Voice: Limit on voice call costs
- Numbers: Limit on phone number rentals
- Features: Limit on optional features
SMS Spending Limit​
curl -X PUT 'https://api.audian.com:8443/v2/billing/limits/sms' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"amount": 100.00,
"action": "alert"
}'
Voice Spending Limit​
curl -X PUT 'https://api.audian.com:8443/v2/billing/limits/voice' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"amount": 200.00,
"action": "alert"
}'
Limit Actions​
Alert Action​
When limit is reached, you'll receive a notification but services continue.
{
"action": "alert",
"notifications": ["email", "sms"]
}
Block Action​
When limit is reached, services are blocked until limit is increased or next month.
{
"action": "block",
"notifications": ["email"]
}
Threshold Alerts​
Set alerts at percentage thresholds:
- 50%: Alert when half the limit is used
- 75%: Alert at 75% usage
- 90%: Alert at 90% usage
- 100%: Alert when limit is reached
Update Spending Limit​
Modify an existing spending limit.
Endpoint​
PUT https://api.audian.com:8443/v2/billing/limits/{limit_id}
Request Example​
curl -X PUT 'https://api.audian.com:8443/v2/billing/limits/limit_abc123' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"amount": 750.00,
"action": "alert"
}'
Delete Spending Limit​
Remove a spending limit.
Endpoint​
DELETE https://api.audian.com:8443/v2/billing/limits/{limit_id}
Request Example​
curl -X DELETE 'https://api.audian.com:8443/v2/billing/limits/limit_abc123' \
-H 'X-Auth-Token: YOUR_API_KEY'
Usage Thresholds​
Set up alerts when usage reaches specific thresholds.
Endpoint​
POST https://api.audian.com:8443/v2/billing/alerts
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Alert name |
metric | string | Yes | Metric to monitor (sms, voice, api, total) |
threshold | number | Yes | Alert threshold value |
type | string | Yes | Threshold type (count, cost) |
notification | array | No | Notification methods |
Request Example​
curl -X POST 'https://api.audian.com:8443/v2/billing/alerts' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "SMS Cost Alert",
"metric": "sms",
"threshold": 100.00,
"type": "cost",
"notification": ["email"]
}'
Notification Preferences​
Set how you want to be notified about limits and alerts.
Endpoint​
PUT https://api.audian.com:8443/v2/billing/notifications
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
email | boolean | No | Email notifications enabled |
sms | boolean | No | SMS notifications enabled |
webhook | string | No | Webhook URL for notifications |
slack | string | No | Slack webhook URL |
Request Example​
curl -X PUT 'https://api.audian.com:8443/v2/billing/notifications' \
-H 'X-Auth-Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"email": true,
"sms": false,
"slack": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
}'
Overage Protection​
Prevent unexpected charges with overage protection.
Enable Overage Protection​
{
"type": "monthly",
"amount": 500.00,
"action": "block",
"overage_protection": true
}
With overage protection:
- API calls are rejected when limit reached
- SMS messages cannot be sent
- Voice calls are blocked
- Services resume on next billing period or limit increase
Hard Limits vs Soft Limits​
Hard Limit (Block Action)​
- Services stop when reached
- Prevents overage charges
- Requires manual intervention to increase
- Best for controlling costs
Soft Limit (Alert Action)​
- Services continue when reached
- You receive alerts
- Allows flexibility for spikes
- Best for monitoring
Usage Dashboard​
Monitor your usage against limits:
- Log into Audian dashboard
- Go to Billing > Spending Limits
- View current usage vs limits
- Adjust limits as needed
Best Practices​
- Set Conservative Limits: Start lower and adjust upward
- Use Multiple Alerts: Set alerts at 50%, 75%, 90%
- Monitor Regularly: Check usage weekly
- Plan for Spikes: Account for expected usage variations
- Enable Notifications: Use multiple notification methods
- Document Changes: Log when limits are adjusted
Examples​
Small Business Setup​
{
"monthly_limit": 500.00,
"daily_limit": 25.00,
"sms_limit": 100.00,
"voice_limit": 200.00
}
Enterprise Setup​
{
"monthly_limit": 5000.00,
"daily_limit": 250.00,
"sms_limit": 1000.00,
"voice_limit": 2000.00
}
Troubleshooting​
| Issue | Solution |
|---|---|
| Limit reached unexpectedly | Check usage breakdown by feature |
| Alert not received | Verify notification preferences |
| Can't increase limit | Contact support for enterprise adjustments |
| Services blocked | Increase limit or disable block action |
FAQ​
Q: Do spending limits include setup fees? A: Yes, all charges count toward limits.
Q: Can I have different limits by number? A: Currently, limits apply account-wide. Contact support for custom arrangements.
Q: What happens if I exceed a hard limit? A: Services stop and you receive a notification. Increase the limit to resume.
Q: Are there minimum limits? A: Minimum monthly limit is $10.
Q: Can I disable all limits? A: Yes, delete all limits. However, we recommend always having at least a monthly limit.
Q: How long does it take to increase a limit? A: Limit increases take effect immediately.