Skip to generator
ADDRESS GUIDES

Random Address Generator API: Parameters and Examples

Generate up to 100 JSON records with the same deterministic engine.

GET /api/addresses

Use a two-letter country code (uk for United Kingdom), optional region, city and postal filters, and a required seed. All location filters must match the same reference; unavailable combinations return 400 without broadening the search. Count defaults to 1 and cannot exceed 100. Unknown parameters are rejected.

curl "http://localhost:3000/api/addresses?country=us&count=2&seed=demo"

Repeatable results

The same parameters produce the same records. Do not submit real personal information. This endpoint has no account, API-key or billing integration. Configure gateway rate limits appropriate for expected traffic before public deployment.

Errors

Invalid countries, regions, quantities or missing seeds return HTTP 400. Successful responses include a data array, count and synthetic flag.

Address API request limits and errors

The public endpoint requires a seed and accepts 1–100 records per request. Keep country and filter values consistent; invalid parameters return HTTP 400. The browser tool supports larger batches of up to 1,000. Syntax-valid output is synthetic test data, not delivery verification.