Developer API

Address Generator API Playground

This tool generates synthetic test data for software testing, QA, form validation, demos, and development workflows. Do not use generated data for fraud, identity verification, payment verification, impersonation, or any illegal activity.

The API playground page is a developer-focused entry point for teams that want structured address records instead of copying values from a table.

Use it to understand the JSON shape, choose country/state/city pages for scoped examples, and build mocks or seed data around consistent synthetic address records.

What this adds beyond a basic address generator

API response shape

A useful address API response should preserve both human-readable and structured fields.

  • fullName
  • street
  • city
  • region
  • postalCode
  • country
  • phone
  • email
  • company

Developer workflows

Use synthetic JSON records anywhere production data would be risky or noisy.

  • API mocks
  • Frontend fixtures
  • Staging seed data
  • QA automation

Consistency checks competitors usually skip

GenAddr keeps the fields in the same generated record aligned instead of mixing unrelated values.

  • City and state stay together.
  • ZIP code belongs to the selected city.
  • Phone number uses a region-appropriate US format.
  • Generated values are clearly marked as synthetic test data.

Example fields

Endpoint style
GET /api/v1/address?country=US&count=3
Response
JSON records
Use case
Mocks, tests, demos, seed data

Example API request

curl "https://genaddr.com/api/v1/address?country=US&count=3"

{
  "records": [
    {
      "fullName": "Mason Sullivan",
      "street": "11533 WESTVIEW PKY",
      "city": "San Diego",
      "region": "California",
      "postalCode": "92126",
      "country": "United States"
    }
  ]
}

Responsible use

  • All generated data is synthetic and does not describe a real person, household, or account.
  • Do not use it for fraud.
  • Do not use it for identity verification.
  • Do not use it for payment verification.
  • Do not use it to impersonate real people.
  • Use it only for testing, QA, demos, development, and education.

Frequently asked questions

Is there a JSON address API?

GenAddr exposes structured address data through the application and API-style examples so teams can build mocks, fixtures, and seed data around the same field model.

What should an address API response include?

At minimum, include name, street, city, region, postal code, country, phone, and email when your product forms collect those fields.

Can I use these examples in production verification?

No. The records are synthetic test data for development, demos, QA, and education.