> ## 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 un finding

> Un finding, de n’importe quelle famille, avec son état de triage, le nombre et les dates de ses détections et sa détection la plus récente. Le jeton doit disposer de la même autorisation de consultation que pour la liste des problèmes de la famille.



## OpenAPI

````yaml /fr/api-reference/openapi.json get /findings/{finding_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:
  /findings/{finding_id}:
    get:
      tags:
        - Findings
      summary: Obtenir un finding
      description: >-
        Un finding, de n’importe quelle famille, avec son état de triage, le
        nombre et les dates de ses détections et sa détection la plus récente.
        Le jeton doit disposer de la même autorisation de consultation que pour
        la liste des problèmes de la famille.
      operationId: getFinding
      parameters:
        - name: finding_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            L’identifiant du finding, tel qu’il apparaît dans finding_id sur les
            éléments de problème
      responses:
        '200':
          description: Finding récupéré avec succès
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  finding:
                    $ref: '#/components/schemas/Finding'
        '403':
          description: Le jeton ne peut pas consulter une famille de findings demandée
        '404':
          description: Aucun finding accessible avec cet identifiant
components:
  schemas:
    Finding:
      type: object
      description: >-
        Une vulnérabilité dans un projet, à travers tous les scans qui l’ont
        détectée. Son identifiant reste stable d’un scan à l’autre, entre
        branches et après les migrations d’empreintes ; le triage est porté ici
        et reflété sur chacune de ses détections (problèmes).
      properties:
        id:
          type: string
          format: uuid
        issue_type:
          type: string
          enum:
            - sast
            - secret
            - logic_auth
            - code_quality
            - dependency
            - container
            - iac
        detection_state:
          type: string
          nullable: true
          enum:
            - active
            - retired
          description: >-
            active tant que le finding possède une détection dans son projet ;
            retired une fois sa dernière détection supprimée avec son scan ou
            son projet. Un finding qu’un nouveau scan ne rapporte plus reste
            active avec le statut fixed. Null tant que l’index des findings du
            compte n’est pas complet.
        status:
          type: string
          enum:
            - open
            - fix_in_progress
            - accepted_risk
            - false_positive
            - fixed
            - duplicate
        status_comment:
          type: string
          nullable: true
        status_changed_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Date du dernier changement de statut ; filtrez dessus avec
            status_changed_since.
        status_changed_by:
          allOf:
            - $ref: '#/components/schemas/AssignedTo'
          nullable: true
          description: Utilisateur à l’origine du dernier changement de statut, ou null.
        accepted_risk_expiry_date:
          type: string
          format: date-time
          nullable: true
        assigned_to:
          $ref: '#/components/schemas/AssignedTo'
        due_date:
          type: string
          format: date-time
          nullable: true
        sla_status:
          type: string
          nullable: true
        urgency:
          type: string
          enum:
            - CR
            - HI
            - ME
            - LO
        classification:
          type: object
          nullable: true
          properties:
            id:
              type: string
              example: CWE-79
            name:
              type: string
            description:
              type: string
              nullable: true
        project:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
        first_detection_date:
          type: string
          format: date-time
          nullable: true
          description: created_at de la détection la plus ancienne.
        last_detection_date:
          type: string
          format: date-time
          nullable: true
          description: created_at de la détection la plus récente.
        detections_count:
          type: integer
          description: Nombre de détections du finding à travers les scans.
        latest_detection:
          allOf:
            - $ref: '#/components/schemas/FindingLatestDetection'
          nullable: true
          description: >-
            La détection la plus récente du finding : son identifiant est celui
            qu’acceptent les points de terminaison de problèmes, et elle porte
            le localisateur propre à sa famille.
    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.
    FindingLatestDetection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: >-
            Identifiant de la détection (problème), pour /issue/{issue_id} et
            /issues/sca/{issue_id}.
        scan_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Scan auquel appartient la détection ; null pour une détection SAST
            ingérée sans scan.
        branch:
          type: string
          nullable: true
        sha:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        file_path:
          type: string
          description: Findings SAST, secrets, logique et qualité de code uniquement.
        line_number:
          type: integer
          nullable: true
          description: Findings SAST, secrets, logique et qualité de code uniquement.
        path:
          type: string
          description: Findings de dépendances, de conteneurs et IaC uniquement.
        package:
          type: string
          description: Findings de dépendances et de conteneurs uniquement.
        version:
          type: string
          description: Findings de dépendances et de conteneurs uniquement.
        cve:
          type: string
          nullable: true
          description: Findings de dépendances et de conteneurs uniquement.
        rule_id:
          type: string
          description: Findings IaC uniquement.
        start_line:
          type: integer
          nullable: true
          description: Findings IaC uniquement.
        end_line:
          type: integer
          nullable: true
          description: Findings IaC uniquement.
  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.