Developers

Random Address API

For developers building automated form tests and demos, generate realistic fake US addresses with invented streets, names and phone numbers. City, state and ZIP fields stay paired for forms, demos and test data.

Request repeatable address records

GET /api/v1/addresses?seed=checkout-spec-17&count=3&state=NY

The same seed, filters, count and data version return the same ordered records. Addresses can repeat within a batch because the source pool is finite. Responses are not cached.

The API accepts up to 20 US records per request. Website batch tools support up to 1,000. Read the API reference for fields, source information and errors.

Current access limits

No key is required. The deployed service limits each client IP to 60 requests per minute; a rate-limited response includes Retry-After. For large local batches, use the bulk address generator.