Billing

Plans

Plan Price Monthly limit Overages
Free €0/mo 100 API calls Not available — requests blocked at limit
Pro €10/mo 5,000 API calls €10 per 1,000 additional calls

Usage tracking

Usage is tracked per API key, per calendar month. Successful requests (status < 400) count against your quota. Cached 304 Not Modified responses are served by your browser/HTTP client and may not reach the API.

Check current usage:

curl "https://openapi.city/api/v1/me" \
  -H "Authorization: Bearer oac_live_YOUR_KEY"

Response includes:

{
  "usage_this_month": 42,
  "monthly_limit": 100
}

Rate limit headers

Every API response includes:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1719792000
  • Limit — your monthly cap
  • Remaining — calls left this month
  • Reset — Unix timestamp when the counter resets (1st of next month)

Free plan limits

When you hit the Free plan limit:

  • Subsequent requests return 429 Too Many Requests
  • No overage charges
  • Counter resets on the 1st of the next month

Pro plan overages

Pro users can exceed 5,000 calls:

  • Requests continue working beyond the limit
  • Overage usage is reported to Stripe in batches of 1,000
  • Each batch costs €10
  • Tracked via Stripe metered billing

Upgrading

  1. Go to Dashboard → Billing
  2. Click Upgrade to Pro
  3. Complete Stripe Checkout
  4. Your limit increases to 5,000 immediately

Managing billing

Access the Stripe Customer Portal at Dashboard → Billing to:

  • Update payment methods
  • Download invoices
  • Cancel subscription

Usage reset

Counters reset automatically on the 1st of each month. There is no manual reset.

Next: Errors →