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

# Obtenir une détection

> Récupère les détails d'une détection spécifique

Également servi sous `/api/v1/issue/{issue_id}`, l’ancien nom de cet endpoint, qui reste pris en charge avec les mêmes paramètres et la même réponse.



## OpenAPI

````yaml /fr/api-reference/openapi.json get /detections/{issue_id}
openapi: 3.0.0
info:
  title: API Corgea
  version: 1.0.0
  description: >-
    API permettant d’interagir avec les fonctionnalités d’analyse et de gestion
    des vulnérabilités de Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Serveur de production
  - url: https://eu.corgea.app/api/v1
    description: Serveur de production UE
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /detections/{issue_id}:
    get:
      tags:
        - Détections
      summary: Obtenir une détection
      description: >-
        Récupère les détails d'une détection spécifique


        Également servi sous `/api/v1/issue/{issue_id}`, l’ancien nom de cet
        endpoint, qui reste pris en charge avec les mêmes paramètres et la même
        réponse.
      operationId: getIssue
      parameters:
        - name: issue_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L'identifiant du problème
        - name: show_full_code
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Indique si le code complet doit être inclus dans la réponse
        - name: include_metadata
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Inclure les identifiants fournis par le scanner dans issue.metadata.
            Omis par défaut ; lorsque ce champ est demandé, metadata vaut null
            si aucun identifiant n’est disponible.
        - name: include_reachability
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Inclure les détails d’accessibilité du point de terminaison pour le
            problème.
        - name: generate_fix
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Définissez sur true pour lancer en arrière-plan la génération d’un
            correctif manquant admissible. S’il est omis ou vaut false, l’état
            actuel du problème est renvoyé sans lancer la génération.
        - name: wait_for_the_fix
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Attend la génération du correctif en arrière-plan avant de répondre.
            S’applique uniquement lorsque generate_fix vaut true et qu’un
            correctif admissible est manquant. L’attente est limitée (120
            secondes par défaut) ; si la génération est toujours en cours, la
            réponse indique generating. Consultez à nouveau le problème pour
            vérifier si le correctif est prêt.
      responses:
        '200':
          description: Détails du problème récupérés avec succès
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  issue:
                    $ref: '#/components/schemas/IssueDetail'
        '404':
          description: Problème introuvable
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  message:
                    type: string
                    example: Issue not found
components:
  schemas:
    IssueDetail:
      type: object
      properties:
        finding_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Identifiant du finding dont ce problème est une détection :
            identique d’un scan à l’autre. Null pour un problème ingéré avant
            l’apparition des findings.
        id:
          type: string
          format: uuid
        scan_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - open
            - fix_in_progress
            - fixed
            - false_positive
            - accepted_risk
            - duplicate
        urgency:
          type: string
          enum:
            - CR
            - HI
            - ME
            - LO
          description: >-
            Code d’urgence : CR (critique), HI (élevée), ME (moyenne) ou LO
            (faible).
        created_at:
          type: string
          format: date-time
        first_detection_date:
          type: string
          format: date-time
          description: >-
            Date à laquelle Corgea a détecté ce problème pour la première fois,
            parmi toutes les analyses où il apparaît. Identique à created_at
            lorsqu’il s’agit de la première détection.
        classification:
          type: object
          nullable: true
          description: >-
            Si le CWE est inconnu ou si la classification est un libellé libre,
            id et name contiennent le libellé de classification d’origine et
            description vaut null. Une classification vide est renvoyée sous la
            forme null.
          properties:
            id:
              type: string
              example: CWE-123
            name:
              type: string
              example: Vulnerability Name
            description:
              type: string
              nullable: true
        location:
          $ref: '#/components/schemas/IssueLocation'
        details:
          type: object
          properties:
            explanation:
              type: string
            policy_guidance:
              type: object
              nullable: true
              description: >-
                Recommandations de la politique applicable à ce problème, ou
                null si aucune recommandation ne s’applique.
              properties:
                policy:
                  type: string
                  description: Nom de la politique
                text:
                  type: string
                  description: Texte des recommandations
            full_code:
              type: string
              description: >-
                Code source complet du fichier concerné. Renvoyé uniquement
                lorsque show_full_code vaut true.
        auto_triage:
          $ref: '#/components/schemas/AutoTriage'
        auto_fix_suggestion:
          $ref: '#/components/schemas/AutoFixSuggestion'
        assigned_to:
          $ref: '#/components/schemas/AssignedTo'
        scanner_metadata:
          type: object
          description: Métadonnées fournies par le scanner et associées au problème.
          additionalProperties:
            type: string
        reachability:
          $ref: '#/components/schemas/IssueReachabilityDetail'
        metadata:
          type: object
          nullable: true
          additionalProperties: true
          description: >-
            Identifiants fournis par le scanner pour ce problème, comme un
            instance_id de Fortify ou un deep_link de Checkmarx. Inclus
            uniquement lorsque include_metadata=true ; vaut null si aucun
            identifiant n’est disponible.
        status_comment:
          type: string
          nullable: true
          description: Commentaire enregistré du changement de statut ; null si absent.
    IssueLocation:
      type: object
      properties:
        file:
          type: object
          properties:
            name:
              type: string
            language:
              type: string
            path:
              type: string
            git_hash:
              type: string
              nullable: true
              description: >-
                Hash Git enregistré pour le fichier analysé. Renvoyé uniquement
                par les points de terminaison qui listent les problèmes.
        project:
          type: object
          properties:
            name:
              type: string
            branch:
              type: string
            git_sha:
              type: string
        line_number:
          type: integer
        sink_line_number:
          type: integer
          nullable: true
          description: >-
            Ligne du point de sortie (sink) du flux de données lorsqu’il se
            trouve dans ce fichier, sinon null. Renvoyé uniquement lors de la
            récupération d’un problème individuel.
    AutoTriage:
      type: object
      properties:
        false_positive_detection:
          type: object
          properties:
            status:
              type: string
              enum:
                - valid
                - false_positive
                - pending
            reasoning:
              description: >-
                Motif du classement comme faux positif, si disponible, même si
                aucun correctif n’a été généré.
              type: string
              nullable: true
    AutoFixSuggestion:
      type: object
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - fix_available
            - no_fix
            - generating
            - false_positive
            - on_hold
            - unsupported
            - plan
          description: >-
            Disponibilité actuelle du correctif. La consultation d’un problème
            lance par défaut la génération en arrière-plan d’un correctif
            manquant admissible. Pendant cette génération, le statut est
            generating ; consultez à nouveau le problème jusqu’à la fin de la
            génération. Si la génération est désactivée ou qu’aucun correctif
            n’est produit, le statut est no_fix.
        patch:
          type: object
          properties:
            diff:
              type: string
              description: >-
                Correctif au format diff unifié. Renvoie une chaîne vide lorsque
                le correctif ne contient aucun diff.
            explanation:
              type: string
              description: >-
                Explication de la façon dont le correctif corrige la
                vulnérabilité
            full_code:
              type: string
              description: >-
                Code source complet du fichier avec le correctif appliqué.
                Renvoyé uniquement lorsque show_full_code vaut true et qu’un
                correctif existe.
    AssignedTo:
      type: object
      nullable: true
      description: >-
        Utilisateur affecté au problème, ou null lorsque le problème n'est pas
        attribué.
      properties:
        id:
          type: string
          description: ID de l’utilisateur assigné.
        email:
          type: string
          format: email
          description: Adresse e-mail de l’utilisateur assigné.
        name:
          type: string
          nullable: true
          description: >-
            Nom d’affichage de l’utilisateur assigné, ou null s’il est
            indisponible.
    IssueReachabilityDetail:
      type: object
      description: >-
        Détails d'accessibilité du point de terminaison renvoyés lorsque
        include_reachability est true.
      properties:
        is_reachable:
          type: boolean
        endpoints:
          type: array
          items:
            $ref: '#/components/schemas/IssueReachabilityEndpoint'
    IssueReachabilityEndpoint:
      type: object
      properties:
        path:
          type: string
        method:
          type: string
        file_path:
          type: string
          nullable: true
        line_number:
          type: integer
          nullable: true
        pathways:
          type: array
          items:
            $ref: '#/components/schemas/IssueReachabilityPathway'
    IssueReachabilityPathway:
      type: object
      properties:
        pathway_id:
          type: string
        total_depth:
          type: integer
        confidence_score:
          type: number
        target:
          type: object
          additionalProperties: true
        steps:
          type: array
          items:
            $ref: '#/components/schemas/IssueReachabilityStep'
    IssueReachabilityStep:
      type: object
      properties:
        depth:
          type: integer
        file_path:
          type: string
        line_number:
          type: integer
        function_name:
          type: string
        target_line_number:
          type: integer
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: >-
        Clé API pour l'authentification Les jetons API des utilisateurs inactifs
        sont refusés.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Jeton d’accès OAuth2 (JWT) dans l’en-tête Authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.