---
title: "Commune par code postal ou par nom (base adresse nationale)"
method: GET
path: "/v1/geo/cities"
tags: ["B2B (v1)"]
---

# Commune par code postal ou par nom (base adresse nationale)

`GET /v1/geo/cities`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/geo/cities`
- Auth: HTTP bearer

Un code postal à 5 chiffres renvoie toutes les communes qui le partagent. Le `label` (« 69003 Lyon ») est la valeur attendue dans le champ `commune` d’un devis ou d’un calculateur.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Communes

- CityResults
  - `results` object[], required
    - `postcode` string, required
    - `city` string, required
    - `label` string, required

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `402`: Crédits ou paiement requis
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `429`: Trop de requêtes
- `500`: Erreur interne
- `502`: Service partenaire en erreur

---

[API](https://skmtc.dev/vitef/apis/api-vitef.md) · [All operations](https://skmtc.dev/vitef/apis/api-vitef/llms.txt) · [OpenAPI document](https://skmtc.dev/vitef/apis/api-vitef/revisions/7bc459d9ef90?raw)