Address Generator API for US & Canadian Test Data

Free random address generator API endpoint

NorthMock exposes a read-only endpoint for development, automated QA, test fixtures, demos, and staging environments. It requires no API key, accepts cross-origin browser requests, and returns one record per request.

Quick request

curl "https://us.chatgpt.org.uk/api/generate?state=CA"

Leave state empty for a random supported US or Canadian region. Send a two-letter region code when the test must stay in one state, province, or territory.

Query parameters

GET /api/generate?state=CA

GET /api/generate?state=NY&city=nyc

GET /api/generate?state=OH&zip=43215

GET /api/generate?state=ON

JavaScript and Python examples

Browser or Node.js fetch

const response = await fetch('https://us.chatgpt.org.uk/api/generate?state=OH&zip=43215', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) {
  const failure = await response.json();
  throw new Error(failure.error.message);
}

const { data, meta } = await response.json();
console.log(data.addressLine, data.locality, data.state, data.postalCode);

Python standard library

import json
from urllib.request import Request, urlopen

url = 'https://us.chatgpt.org.uk/api/generate?state=ON'
request = Request(url, headers={'Accept': 'application/json'})

with urlopen(request) as response:
    payload = json.load(response)

print(payload['data']['address'])

JSON response fields

The endpoint returns a data object for the generated record and a meta object describing generation time, intended use, name sources, and safe-phone policy. The abbreviated example uses bracketed placeholders instead of publishing a source address or a generated identity in indexable HTML.

{
  "data": {
    "address": "[selected address], Los Angeles, CA 90001, United States",
    "addressLine": "[selected street line]",
    "locality": "Los Angeles",
    "postalCode": "90001",
    "name": "[generated name]",
    "gender": "Female",
    "email": "[generated mailbox]@gravityengine.cc",
    "inboxUrl": "https://mail.chatgpt.org.uk/[generated mailbox]@gravityengine.cc",
    "phone": "(213) 555-0100",
    "phoneInternational": "+1 213-555-0100",
    "phoneE164": "+12135550100",
    "phoneAssignedPrefix": "(213) 234-XXXX",
    "state": "CA",
    "country": "US",
    "region": {
      "code": "CA",
      "name": "California",
      "country": "US",
      "countryName": "United States",
      "path": "/us/california-address-generator/"
    },
    "city": null,
    "filters": {
      "city": null,
      "zipCode": null
    }
  },
  "meta": {
    "generatedAt": "2026-08-12T00:00:00.000Z",
    "intendedUse": "development-and-testing"
  }
}

Error responses and status codes

Failures use a consistent { "error": { "code", "message" } } body. Generated responses are never cached; clients should handle status codes before reading data.

CORS, caching, batching, and responsible use

• CORS: GET and OPTIONS are supported. The production endpoint currently allows cross-origin requests.
• Caching: generated records use Cache-Control: no-store. The descriptive /api/ index may be cached briefly.
• Batching: the endpoint returns one record. Use the browser generator for deduplicated batches of up to 25 and local CSV or JSON export.
• Address boundary: an address may describe a real place, but the generated name, mailbox, and safe phone are assembled independently and do not identify an occupant.
• Permitted use: use records only for development, QA, education, demos, and staging—not physical mail, residency claims, impersonation, fraud, or bypassing identity checks.

See the NorthMock data methodology for source and validation boundaries, or the bulk address test-data guide for browser export fields.