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.
GET/v4/address
Parameters
| Parameter | Required | Description |
|---|---|---|
country | No | Country code: fr, us, uk, de, or es. Case-insensitive. Random if omitted. |
count | No | Number of addresses to generate (1–10). Default: 1. |
Response Fields
| Field | Type | Description |
|---|---|---|
addresses | object[] | List of generated address objects |
addresses[].street | string | House number + street type + street name |
addresses[].city | string | City name |
addresses[].zip | string | Postal/zip code formatted for the country |
addresses[].state | string | Region or state name |
addresses[].country | string | Full country name (e.g. France, United States) |
addresses[].countryCode | string | Uppercased country code (e.g. FR, US) |
Supported Countries
| Code | Country | Zip format example |
|---|---|---|
fr | France | 75001 |
us | United States | 90210 |
uk | United Kingdom | AB1 2CD |
de | Germany | 10115 |
es | Spain | 28001 |
Code Examples
curl -X GET \
"https://api.sylvain.sh/v4/address"Try It
Error Handling
| Error Message | Description |
|---|---|
Unknown country code "xx". Supported: fr, us, uk, de, es | The country parameter is not a supported code |
Count must be between 1 and 10 | The count parameter is out of the allowed range |