Rate Limits

PhantomJSON enforces rate limiting to ensure fair usage and API stability.

Default Limits

Tier	Requests	Time Window
Anonymous	100	1 minute

Rate Limit Headers

Every response includes rate limit information in the headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 60

Header	Description
X-RateLimit-Limit	Maximum requests allowed per window
X-RateLimit-Remaining	Requests remaining in current window
X-RateLimit-Reset	Seconds until the rate limit resets

When Rate Limited

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response:

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded",
  "path": "/v1/users",
  "timestamp": "2026-01-15T10:30:00.000Z"
}

Best Practices

1. Cache responses — Cache API responses to reduce unnecessary requests
2. Use pagination — Fetch only the data you need with appropriate limit values
3. Combine queries — Use filtering, sorting, and search to get exactly what you need in one request
4. Monitor headers — Check X-RateLimit-Remaining to avoid hitting limits

Example: Checking Rate Limits

curl -I https://api.phantomjson.app/v1/users

Response headers:

HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 59
Content-Type: application/json