Rate Limits

maps.guru enforces rate limits to ensure fair usage and platform stability. Limits vary by subscription tier and are tracked per organization.

Tier Quotas

How Limits Work

Monthly Reset

All quotas reset on the first day of each calendar month (UTC). Unused requests do not roll over.

Real-Time Tracking

Usage is tracked in real-time using Cloudflare Durable Objects. You can monitor current usage from the dashboard or via the API:

curl -H "Authorization: Bearer mapx_your_key" \
  "https://api.maps.guru/v1/usage/current"

Quota Exceeded

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

{
  "statusCode": 429,
  "message": "Monthly quota exceeded for maps service. Upgrade your plan at https://maps.guru/dashboard/billing"
}

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit: 500000
X-RateLimit-Remaining: 499234
X-RateLimit-Reset: 2025-02-01T00:00:00Z

Upgrading

If you're consistently hitting limits, consider upgrading your plan:

1. Go to Dashboard → Billing
2. Select a higher tier
3. Quotas are updated immediately — no waiting for the next billing cycle