Rate Limits & Usage Quotas

Free tier plan entitlements, sliding-window rate limiters, and Retry-After headers.

BehaviorSim enforces fair-use rate limits and monthly quotas to ensure dependable availability.

Free Plan Entitlements

Verified default limits for all standard developer accounts:

Short-Term Rate Limit

5 req / min

Sliding-window limiter

Monthly Request Quota

100 req / mo

Resets on 1st of month

Monthly Interactions

10,000 / mo

Total generated steps

Max Per Request

1,000 steps

Per simulation payload

Concurrency

1 simulation

Simultaneous execution

Developer Keys

1 active key

Per free user account

Rate Limits vs. Monthly Quotas

Rate Limit (5 req/min): Protects compute resources against bursts. Exceeding this returns HTTP 429 Too Many Requests with a Retry-After header.
Monthly Quota (10,000 interactions): Monthly allowance. Exceeding this returns HTTP 403 Forbidden until the next billing calendar cycle.

Handling HTTP 429 & Retry-After

When throttled, inspect the Retry-After header to delay subsequent attempts:

rate_limit_response.json

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 48
X-Request-ID: req_rate_limit_001

{
  "error": {
    "message": "Rate limit exceeded. Maximum allowed: 5 requests per minute.",
    "status_code": 429,
    "details": {
      "code": "rate_limit_exceeded",
      "limit": 5,
      "retry_after": 48
    },
    "request_id": "req_rate_limit_001"
  }
}

Monitoring Usage

You can programmatically query your remaining request and interaction quotas at any time by calling GET /v1/usage.

PreviousErrors & Status Codes