France postal code API

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).

GET /v3/FR/75001
[
  {
    "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

200 OK
[
  {
    "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.

Start in minutes

Create a free key, then copy a working example in cURL, Python, Node.js, PHP or Ruby.