Developers
Synthetic Address API
The API returns fictional records with a curated locality–ZIP pairing, a reproducible seed, and an explicit not_checked delivery status.
Start with a repeatable address request.
GET /api/v1/addresses?seed=checkout-spec-17&count=3&state=NY
The same seed + filters + source version produces the same ordered records. Responses are deliberately non-cacheable because user-selected seeds belong to test workflows, not search indexes.
Read the full API reference for field schema, exact bounds, status codes, and rate-limit behavior.
Anonymous limit
20 records per API request; the browser generator permits up to 1,000 local records.
Rate limit
60 requests per minute per client IP in the deployed Worker. Local preview explains its in-isolate fallback.
No key yet
There are no accounts or keys at launch. Do not rely on this endpoint for high-volume production workloads.