Rate Limits

Understand request quotas and rate limiting.

Monthly Quota System

The Traceline API uses a monthly quota system rather than per-second rate limiting. Each plan has a fixed number of requests per billing period.

Quotas reset at the start of each billing period. Unused requests do not roll over.

Plan Limits

PlanMonthly QuotaPrice
Free100 requests/month$0
Pro10,000 requests/month$200/month
EnterpriseUnlimitedCustom

Tracking Your Quota

Every API response includes headers showing your current quota status:

  • X-Monthly-Quota-Limit — Your total monthly quota
  • X-Monthly-Quota-Remaining — Remaining requests this month

Example Response Headers

HTTP/1.1 200 OK
Content-Type: application/json
X-Monthly-Quota-Limit: 100
X-Monthly-Quota-Remaining: 58

Quota Exceeded

When you exceed your monthly quota, the API returns a 402 status code:

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly quota exceeded. Upgrade your plan or wait for the next billing period."
  }
}

Upgrade your plan to get more requests.