Address Generation

The /address endpoint generates one or more fictional postal addresses for a given country. Each address includes a street, city, zip code, region, and country name. If no country is specified, one is picked at random.

gethttps://api.moxon.dev/v5/address

Try itget/v5/address

curl -X GET \  "https://api.moxon.dev/v5/address"

Send the request to see the response here.

Parameters

countrystringoptional
Country code: fr, us, uk, de, or es. Case-insensitive. Random if omitted.
- fr
- us
- uk
- de
- es
countnumberoptional
Number of addresses to generate (1–10). Default: 1.

Response Fields

addressesobject[]
List of generated address objects
addresses[].streetstring
House number, street name and type — word order depends on country (see below)
addresses[].citystring
City name
addresses[].zipstring
Postal/zip code formatted for the country
addresses[].statestring
Region or state name
addresses[].countrystring
Full country name (e.g. France, United States)
addresses[].countryCodestring
Uppercased country code (e.g. FR, US)

Supported Countries

Code	Country	Zip format example	Street word order
`fr`	France	`75001`	number + type + name
`us`	United States	`90210`	number + name + type
`uk`	United Kingdom	`AB1 2CD`	number + name + type
`de`	Germany	`10115`	number + name + type
`es`	Spain	`28001`	number + type + name

us, uk, and de addresses put the street type last (e.g. 42 Main Street), while fr and es put it right after the number (e.g. 12 Rue de Paris).

Code Examples

curl -X GET \  "https://api.moxon.dev/v5/address"

Error Handling

400Unknown country code "xx". Supported: fr, us, uk, de, esThe country parameter is not a supported code
400Count must be between 1 and 10The count parameter is out of the allowed range
400Please provide a valid count (&count={n})The count parameter is not a valid number

Edit this page on GitHub Report an issue

Last updated on July 26, 2026