> ## Documentation Index
> Fetch the complete documentation index at: https://docs.colismove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les villes

> Retourne toutes les villes pour un identifiant de pays donné



## OpenAPI

````yaml GET /v1/api/reference/countries/{countryId}/cities
openapi: 3.1.0
info:
  title: API ColisMove
  description: >-
    API de transport de colis entre particuliers — plateforme de livraison de
    colis peer-to-peer.
  contact:
    name: ColisMove
    url: https://colismove.com
    email: support@colismove.com
  version: 2.0.0
servers:
  - url: http://localhost:3091
    description: Generated server url
security:
  - bearerAuth: []
tags:
  - name: Analytique
    description: API d'analytique et de reporting de la plateforme
  - name: Factures
    description: Reçus de paiement Stripe pour les réservations
  - name: Avis
    description: Endpoints pour créer et lister les avis utilisateurs
  - name: Agences (Admin)
    description: Gestion des agences superadmin (suspendre, activer)
  - name: KYC d'agence (Admin)
    description: Revue admin des documents KYC d'agence
  - name: Utilisateurs
    description: >-
      Consultation et mise à jour du profil utilisateur, et solde du
      portefeuille
  - name: Données de référence
    description: Endpoints de données de référence statiques pour les pays et les villes
  - name: Agences
    description: Inscription, consultation et mise à jour d'agence
  - name: Téléversement de fichiers
    description: Téléversement de fichiers vers le stockage S3/MinIO
  - name: Paiements
    description: Création de sessions Stripe Checkout, statut et callbacks navigateur
  - name: Transactions
    description: Historique, synthèses et détails des transactions financières
  - name: Annonces
    description: >-
      Gestion des annonces de transport (créer, rechercher, mettre à jour,
      supprimer)
  - name: Portefeuille d'agence
    description: Portefeuille d'agence, onboarding Stripe et retraits
  - name: Retraits
    description: >-
      Demandes manuelles de retrait du portefeuille vers le compte Stripe
      connecté
  - name: KYC d'agence
    description: Téléversement et listage des documents KYC d'agence (côté propriétaire)
  - name: Webhooks Didit
    description: Callbacks webhook KYC Didit et gestion des redirections
  - name: Tableau de bord
    description: Endpoints de statistiques du tableau de bord
  - name: Litiges (Admin)
    description: Endpoints admin pour la gestion des litiges
  - name: Authentification
    description: >-
      Authentification utilisateur, inscription, OAuth2 et gestion des mots de
      passe
  - name: Stripe Connect
    description: Onboarding Stripe Connect, statut de compte et gestion des redirections
  - name: Alertes de recherche
    description: Endpoints CRUD pour les alertes de recherche des utilisateurs
  - name: Employés d'agence
    description: Gestion des employés d'agence (côté propriétaire)
  - name: Signalements
    description: Endpoints utilisateur pour créer et consulter les signalements
  - name: Gestion du cache
    description: Administration et supervision du cache
  - name: Page de livraison
    description: Page publique destinataire avec QR code dynamique pour la livraison
  - name: Retraits automatiques
    description: Configuration des retraits automatiques (activation/désactivation, seuil)
  - name: Super Admin
    description: API d'administration avancée de la plateforme
  - name: Signalements (Admin)
    description: Endpoints admin pour la gestion des signalements d'utilisateurs
  - name: Litiges
    description: Endpoints utilisateur pour ouvrir et consulter les litiges
  - name: Branches
    description: Gestion des branches d'agence (CRUD, activation/désactivation)
  - name: Réservations (Hex)
    description: Opérations sur le cycle de vie des réservations — module hexagonal
  - name: Vérification KYC
    description: Vérification d'identité utilisateur via Didit
  - name: Notifications in-app
    description: Endpoints pour lister et gérer les notifications in-app
  - name: Webhooks Stripe
    description: Traitement des événements webhook entrants Stripe
  - name: Catégories de colis
    description: Opérations CRUD sur les catégories de colis
  - name: QR code
    description: Génération de QR code dynamique, validation et traitement de la livraison
  - name: Avis (Legacy)
    description: Page de collecte d'avis clients (Trustpilot)
  - name: Suivi
    description: Endpoints de suivi GPS pour les livraisons de réservations
paths:
  /v1/api/reference/countries/{countryId}/cities:
    get:
      tags:
        - Données de référence
      summary: Obtenir les villes par pays
      description: Retourne toutes les villes pour un identifiant de pays donné
      operationId: getCitiesByCountry
      parameters:
        - name: countryId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Cities retrieved successfully
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/City'
        '404':
          description: No cities found for the given country
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/City'
components:
  schemas:
    City:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        countryId:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      description: JWT access token from POST /v1/api/auth/login
      scheme: bearer
      bearerFormat: JWT

````