Rate limits and credits

Credits

Data-bearing calls consume credits from your monthly allowance. The free tier includes 10,000 credits per month, no card required; paid plans raise the allowance. A full dataset download costs 10 credits, coordinates cost 15, and an archive month costs 20. Listing, metadata, and free samples cost nothing, so you can browse and inspect before spending.

Rate limits

Requests are rate-limited per key across rolling windows: 50 per second, 200 per 10 seconds, and 1,000 per minute. Exceeding a window returns 429 Too Many Requests.

Tip · Handle limits well

Read 429 as a signal to slow down, not to retry immediately — back off with exponential delay. Batch where you can (page OGC items with limit up to 1,000 rather than fetching features one by one), cache dataset files locally and refresh on the dataset's cadence, and use free samples during development.

Track consumption

Check what you have spent from the account portal or via the API over a date range, then set your own alerts.

curl -H "Authorization: Bearer ..." \
  "https://api.topolab.nl/v1/credits/{organizationId}/api-usage?startDate=2026-05-01&endDate=2026-05-31"