Address Generator API

dummyaddress.org exposes one unauthenticated endpoint: POST /api/generate. Use it from curl, CI, or a seed script. No key, no OAuth, no rate-limit account. Cap is 500 synthetic rows. They are not deliverable.

The body is JSON with a place selection (countrySlug required; stateSlug and citySlug optional) and a count. Unknown places return 400. The response is JSON with count and an addresses array. Browser users can also download CSV, XML, YAML, vCard, and SQL from any generator page.

curl

curl -sS -X POST https://dummyaddress.org/api/generate \
  -H 'content-type: application/json' \
  -d '{"selection":{"countrySlug":"united-states","stateSlug":"california","citySlug":"los-angeles"},"count":2}'

JSON example

{
  "generated_by": "dummyaddress.org",
  "disclaimer": "Synthetic, format-correct dummy addresses for testing and design only. Not deliverable. Not for shipping, billing, or legal use.",
  "count": 2,
  "addresses": [
    {
      "street": "11199 Lisandro Route",
      "city": "Los Angeles",
      "state": "CA",
      "postal_code": "90035",
      "country": "United States",
      "country_iso": "US",
      "phone": "+1 (424) 554-2893",
      "latitude": 34.04316,
      "longitude": -118.23244,
      "timezone": "America/Los_Angeles"
    },
    {
      "street": "4767 Frida Forges, Apt 4",
      "city": "Los Angeles",
      "state": "CA",
      "postal_code": "90061-6709",
      "country": "United States",
      "country_iso": "US",
      "phone": "+1 (424) 987-6698",
      "latitude": 34.05799,
      "longitude": -118.25585,
      "timezone": "America/Los_Angeles"
    }
  ]
}

CSV example

street,city,state,postal_code,country,country_iso,phone,latitude,longitude,timezone
11199 Lisandro Route,Los Angeles,CA,90035,United States,US,+1 (424) 554-2893,34.04316,-118.23244,America/Los_Angeles
"4767 Frida Forges, Apt 4",Los Angeles,CA,90061-6709,United States,US,+1 (424) 987-6698,34.05799,-118.25585,America/Los_Angeles

Selection slugs

countrySlug values match our atlas (united-states, united-kingdom, india). US states use names like california and texas. Cities use los-angeles, seattle, london. Ranking pages such as Random US Address Generator and Seattle call the same generator in the browser.

We never return SSNs or credit cards. Phones are invented. See dummyaddress.org privacy and terms. This docs URL is /address-generator-api, not a thin /api stub.