Rate Limits

Requests to /cards/* endpoints are rate-limited per API key, per day.

Daily Limits

Counters reset at midnight UTC every day.

How It Works

• Each call to /cards/search, /cards/{game}/{id}, or /cards/batch counts as 1 request
• Limits are tracked per API key, not per IP address
• GET /games and GET /health are not rate-limited

Rate Limit Headers

Every response from /cards/* endpoints includes these headers:

Use these headers to monitor your usage and throttle requests accordingly.

When You Hit the Limit

You'll receive a 429 Too Many Requests:

{
  "statusCode": 429,
  "message": "Daily rate limit of 100 requests exceeded for FREE plan",
  "timestamp": "2026-04-07T15:39:00.000Z"
}

Need More?

Upgrade your plan for higher limits:

• Premium (€9.99/mo) — 10x requests, 2.5x batch size
• Pro (€13.99/mo) — 100x requests, 5x batch size