A small API. A world of fixtures.
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.