Rate Limits

Rate limits are enforced per API key on a rolling 24-hour window.

Tier	Daily Limit	Burst Rate	Price
Free	100 requests	10 req/min	$0
Starter	10,000 requests	100 req/min	From $149/mo
Pro	100,000 requests	500 req/min	From $299/mo
Enterprise	Unlimited	Unlimited	Custom

Response Headers

Every API response includes rate limit headers:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9847
X-RateLimit-Reset: 1711008000
Retry-After: 3600   # Only sent with 429 responses

Handling 429 Responses

When you exceed your rate limit, the API returns a 429 Too Many Requests response:

{
  "error": "rate_limit_exceeded",
  "message": "Daily request limit reached. Resets at 2026-03-21T00:00:00Z.",
  "retry_after": 3600,
  "upgrade_url": "https://haulcommand.com/developers"
}

Best practice: Implement exponential backoff with jitter. Cache responses when possible.