Rate Limit Details

Detailed breakdown of Audian API rate limits by endpoint and plan.

Global Rate Limits

These limits apply to all authenticated requests:

Metric	Free	Starter	Professional	Enterprise
Requests/minute	10	50	100	Custom
Requests/hour	500	2,500	5,000	Custom
Requests/day	5,000	50,000	100,000	Custom
Concurrent connections	5	10	20	Custom
Timeout (seconds)	30	30	30	Custom

Endpoint-Specific Limits

Numbers API

Search Endpoints

Endpoint	Free	Starter	Professional
/numbers/search	2/min	5/min	10/min
/numbers/{id}	50/min	100/min	200/min
/numbers/list	20/min	50/min	100/min

Search Limit Increase:

• Upgrade to Starter: 5 requests/minute
• Upgrade to Professional: 10 requests/minute
• Contact Enterprise: Custom limits

Purchase Endpoints

Endpoint	Limit	Notes
POST /numbers/purchase	5/min	Limited to prevent accidental bulk purchases
DELETE /numbers/{id}	10/min	Release phone numbers

Porting Endpoints

Endpoint	Limit	Notes
POST /ports	2/min	Porting requests are resource-intensive
GET /ports/{id}	50/min	Check port status frequently if needed
GET /ports	20/min	List all active ports

Configuration Endpoints

Endpoint	Limit	Notes
PUT /numbers/{id}/config	20/min	Update number configuration
GET /numbers/{id}/config	100/min	Retrieve configuration
PUT /numbers/{id}/caller-id	20/min	Update caller ID
GET /numbers/{id}/caller-id	100/min	Get caller ID settings

SMS API

Endpoint	Free	Starter	Professional
POST /sms/send	10/min	50/min	100/min
POST /sms/batch	2/min	5/min	10/min
GET /sms/{id}	100/min	200/min	500/min
GET /sms/list	20/min	50/min	100/min

Voice API

Endpoint	Free	Starter	Professional
POST /calls/make	5/min	20/min	50/min
GET /calls/{id}	100/min	200/min	500/min
GET /calls/list	20/min	50/min	100/min
POST /calls/{id}/hangup	20/min	50/min	100/min

Billing API

Endpoint	Limit	Notes
GET /billing/usage	20/min	Check usage and costs
GET /billing/invoices	30/min	List invoices
GET /billing/transactions	30/min	List transactions
PUT /billing/limits/*	10/min	Set spending limits

E911 API

Endpoint	Limit	Notes
PUT /numbers/{id}/e911	10/min	Update E911 address
GET /numbers/{id}/e911	100/min	Get E911 address
DELETE /numbers/{id}/e911	10/min	Remove E911 address

Rate Limit Window Examples

Per-Minute Window

Current time: 14:30:00
Window: 14:29:00 - 14:30:00
Limit: 50 requests
Remaining: 23 requests

As time progresses:

• 14:30:05: Oldest request from 14:29:00 falls out of window
• 14:30:06: Another request from 14:29:01 falls out
• Available quota gradually replenishes

Per-Hour Window

Current time: 14:30:00
Window: 13:30:00 - 14:30:00
Limit: 2,500 requests
Used: 1,800 requests
Remaining: 700 requests

Per-Day Window

Current time: 14:30:00 (Feb 4, 2024)
Window: Feb 3 14:30:00 - Feb 4 14:30:00
Limit: 100,000 requests
Used: 78,456 requests
Remaining: 21,544 requests

Burst Handling

Audian allows short bursts above the per-minute limit if you have unused quota from longer windows:

Per-minute: 100 requests
Per-hour: 5,000 requests

At minute 1: Use 150 requests (above per-minute but within per-hour)
Remaining in minute: -50 (burst allowed)
Remaining in hour: 4,850

Next requests will be rate limited until per-minute window allows them.

Overage Behavior

When rate limit is exceeded:

1. 429 Response: Request is rejected
2. Retry-After Header: Specifies wait time
3. Rate Limit Headers: Show limit status
4. Error Message: Explains the limit exceeded

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded: 100 requests per minute",
    "reset_in_seconds": 45,
    "limit_type": "per_minute"
  }
}

Rate Limit Sharing

Rate limits are per API key:

• Each API key has independent limits
• Create multiple API keys to split load
• Different team members can use separate keys

Example Setup

Team A API Key: 100 requests/minute
Team B API Key: 100 requests/minute
Total possible: 200 requests/minute

Special Limits

Search Operations

Number search is limited more strictly due to database load:

• Starter plan: 5/minute
• Professional plan: 10/minute

Porting Operations

Number porting has strict limits:

• All plans: 2 requests/minute
• Prevents accidental bulk porting requests

Webhook Deliveries

When you receive webhooks:

• No rate limit on receiving webhooks
• You must respond within 30 seconds
• Failed webhooks are retried

Upgrading Rate Limits

Free → Starter

Free plan limits        Starter plan limits
10 requests/min    →    50 requests/min
500 requests/hour  →    2,500 requests/hour
5,000 requests/day →    50,000 requests/day

Starter → Professional

Starter limits          Professional limits
50 requests/min    →    100 requests/min
2,500 requests/hour →   5,000 requests/hour
50,000 requests/day →   100,000 requests/day

Professional → Enterprise

Contact sales for custom limits based on your needs.

Rate Limit Status Codes

200 OK

Request successful, within limits:

RateLimit-Remaining: 45

429 Too Many Requests

Rate limit exceeded:

HTTP/1.1 429 Too Many Requests
RateLimit-Remaining: 0
Retry-After: 60

Best Practices

1. Monitor Limits: Check headers in responses
2. Implement Backoff: Respect Retry-After header
3. Cache Results: Avoid repeated requests
4. Use Webhooks: React to events instead of polling
5. Batch Operations: Combine requests when possible
6. Plan Capacity: Choose appropriate plan tier

FAQ

Q: Can I have different limits per endpoint? A: No, limits apply globally per API key.

Q: Do failed requests count toward limits? A: Yes, all HTTP requests count, including 4xx and 5xx responses.

Q: Can I request temporary limit increase? A: Yes, contact support with your use case.

Q: Do webhook deliveries count? A: No, webhooks are one-way and don't count as API requests.

Q: What about concurrent connections? A: Limits apply to concurrent requests to API endpoints.

Q: Do rate limits reset at specific times? A: Limits use sliding windows, not fixed reset times.