Mockaroo · Rate Limits

Mockaroo Rate Limits

Mockaroo enforces per-API-key daily quotas tied to the account's subscription plan. The Free plan permits 200 API requests per day; Silver allows 1,000,000 records per day; Gold allows 10,000,000 records per day; Enterprise is unlimited. Per-request record caps also vary by plan (1,000 on Free, 100,000 on Silver, 10,000,000 on Gold, unlimited on Enterprise). Synchronous generation is capped at 5,000 records per download on Free accounts when background=false; larger jobs must use the background=true flag and poll /api/downloads/{id} for status. There is no documented per-second rate limit; quotas are enforced over the rolling daily window.

Mockaroo Rate Limits is the machine-readable rate-limit profile for Mockaroo on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 9 rate-limit definitions, measuring requests_per_day, records_per_request, records_per_day, and concurrent_requests.

The profile also includes 4 backoff/retry policies defined and response codes documented for quotaExceeded and throttled.

Tagged areas include Rate Limiting, Test Data, and Mock Data.

9 Limits Throttle: 429 Quota: 429
Rate LimitingTest DataMock Data

Limits

Free plan API requests per day key
requests_per_day · day
200
Free accounts are limited to 200 API requests per day.
Free plan records per file key
records_per_request · usage
1000
Free accounts can generate at most 1,000 records per file.
Free plan synchronous download cap key
records_per_request · usage
5000
Free accounts are capped at 5,000 records per synchronous download when background=false. Larger jobs require background=true (paid plans only).
Silver plan records per day key
records_per_day · day
1000000
Silver accounts can generate up to 1,000,000 records per day.
Silver plan records per file key
records_per_request · usage
100000
Silver accounts can generate up to 100,000 records per file.
Gold plan records per day key
records_per_day · day
10000000
Gold accounts can generate up to 10,000,000 records per day.
Gold plan records per file key
records_per_request · usage
10000000
Gold accounts can generate up to 10,000,000 records per file.
Enterprise plan records per day account
records_per_day · day
-1
Enterprise (self-hosted Docker) accounts have no generation quota.
Background job concurrency key
concurrent_requests
see vendor docs
Long-running generations should be issued with background=true; status is polled via GET /api/downloads/{id}.

Policies

API key scoping
All limits are scoped to the API key associated with the account. Each account has a single API key shown in the My Account page; quotas reset daily.
Quota exhaustion
Once the daily quota is exhausted the API returns HTTP 429 until the quota window resets. The mockaroo-node SDK surfaces this as a UsageLimitExceededError.
Background generation
Jobs exceeding the synchronous record cap must set background=true. Mockaroo returns a download id which can be polled via /api/downloads/{id} for status, percent complete, and the final URL.
Upgrade to raise limits
Higher per-day and per-request limits are obtained by upgrading the account plan (Free → Silver → Gold) or by deploying Enterprise via Docker for unlimited self-hosted generation.

Sources