> ## 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 toutes les catégories de colis ## OpenAPI ````yaml GET /v1/api/categories 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/categories: get: tags: - Catégories de colis summary: Lister toutes les catégories de colis operationId: getAllCategories responses: '200': description: Categories returned successfully content: '*/*': schema: type: array items: $ref: '#/components/schemas/CategorieColisResult' '401': description: Authentication required — missing or expired JWT token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden — insufficient permissions or not resource owner content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: CategorieColisResult: type: object properties: id: type: integer format: int32 code: type: string name: type: string ErrorResponse: type: object description: Standard error response from GlobalExceptionHandler properties: status: type: integer format: int32 description: HTTP status code example: 404 errorCode: type: string description: Application error code enum: - RESOURCE_NOT_FOUND - VALIDATION_ERROR - BUSINESS_RULE_VIOLATION - ALREADY_EXISTS - AUTHENTICATION_ERROR - UNAUTHORIZED - ACCESS_DENIED - PAYMENT_ERROR - PAYMENT_PROCESSING_ERROR - INSUFFICIENT_FUNDS - STRIPE_CONNECT_NOT_CONFIGURED - INVALID_ARGUMENT - INVALID_STATE - MISSING_PARAMETER - TYPE_MISMATCH - ENDPOINT_NOT_FOUND - INTERNAL_ERROR example: RESOURCE_NOT_FOUND message: type: string description: Human-readable error message example: Ressource non trouvée timestamp: type: string format: date-time description: Error timestamp path: type: string description: Request URI that caused the error example: /v1/api/bookings/123 debugInfo: type: string description: Debug details (dev mode only) suggestions: type: array description: Suggestions to resolve the error items: type: string fieldErrors: type: array description: Field-level validation errors (400 responses) items: $ref: '#/components/schemas/FieldError' FieldError: type: object description: Field-level validation error detail properties: field: type: string description: Field name example: email message: type: string description: Validation message example: must not be blank rejectedValue: type: object description: The rejected value securitySchemes: bearerAuth: type: http description: JWT access token from POST /v1/api/auth/login scheme: bearer bearerFormat: JWT ````