France postal code API (Code postal)
Turn any 5-digit French code postal into its commune, department, region, coordinates and Europe/Paris timezone. Sourced from BAN (Base Adresse Nationale) and Geonames, with multi-commune arrays out of the box.
Try a live FR lookup
Try a 5-digit French code postal (e.g. 75001 for Paris).
[
{
"country": "FR",
"postal_code": "75001",
"city": "Paris",
"county": "Paris",
"state": "Γle-de-France",
"state_short": "IDF",
"latitude": 48.8634,
"longitude": 2.3324,
"timezone": "Europe/Paris",
"geohash": "u09tvw0f6s2p"
}
]
Call it from your code or agent
Pass your API key in the x-key header:
curl -H "x-key: YOUR_KEY" https://zip.getziptastic.com/v3/FR/75001
v3 Response
[
{
"country": "FR",
"postal_code": "75001",
"city": "Paris",
"county": "Paris",
"state": "Γle-de-France",
"state_short": "IDF",
"latitude": 48.8634,
"longitude": 2.3324,
"timezone": "Europe/Paris",
"geohash": "u09tvw0f6s2p"
}
]
In France, a single 5-digit code postal often covers multiple communes. The /v3 endpoint returns an array containing every place tied to that code in rank order, with the primary locality first. See the field reference for details.
Why developers use Ziptastic for French postcodes
- Sourced from BAN: French postal codes are built from the Base Adresse Nationale (adresse.data.gouv.fr) alongside Geonames, giving authoritative commune names and coordinates.
- Multi-commune postal codes: Rural French postal codes frequently span several villages. /v3 returns all matching communes in a JSON array so checkout and address forms can let the user pick.
- Batch & forgiving resolve: Resolve up to 100 French and European codes in one POST /v3/batch request, or pass free-text strings to /v3/resolve.
- Reverse geocoding & city search: Find the nearest French code postal from GPS coordinates or search communes by prefix with /v3/city_search/FR/<city>.
From France to 123 countries and territories
Whether you are building an e-commerce checkout for France or enriching European customer records, Ziptastic returns consistent JSON fields (city, state, state_short, county, latitude, longitude, timezone, geohash) across every country.
One API key covers 123 countries and territories and over 2.8 million postal codes, starting with 100 free requests a day on the Developer plan.
Free plan included
The free Developer plan gives you an API key with 100 requests a day on the full v3 API across all 123 countries and territories, and no card is required. When you outgrow it, paid plans scale up to 1,000,000 requests a day.
Explore other postal code APIs
Start in minutes
Create a free key, then copy a working example in cURL, Python, Node.js, PHP or Ruby.