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

# Elenca le finding del code scan (API Devin)

> Elenca le finding dei code scan di Devin per un'organizzazione, filtrate per scansione, repository, gravità o stato, tramite l'API v3 delle organizzazioni

<div id="permissions">
  ## Autorizzazioni
</div>

Richiede un [utente di servizio](/it/api-reference/v3/service-users/members-service-users) o un [token di accesso personale](/it/api-reference/personal-access-tokens) con l'autorizzazione `ViewCodeScans` a livello dell'organizzazione.

<div id="related">
  ## Correlati
</div>

* Filtra per `scan_id` dopo che una scansione avviata con [Avvia Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-start) ha raggiunto lo stato `completed` (consulta [Elenca Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-list) per il polling).
* Avvia una soluzione per un finding con [Risolvi finding di Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-remediate).
* Per i conteggi aggregati di scansioni, finding e PR di remediation in un intervallo di tempo, usa [Ottieni metriche di Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-metrics).
* Per il flusso di lavoro end-to-end, consulta [Attivare Code Scan tramite l'API Devin](/it/api-reference/v3/code-scans/triggering-code-scans).


## OpenAPI

````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/findings
openapi: 3.1.0
info:
  description: API Devin v3 con autenticazione utente di servizio e RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3/organizations/{org_id}/code-scans/findings:
    get:
      tags:
        - code-scans
      summary: Elencare i risultati del code scan
      description: >-
        Elenca i finding del code scan per l'organizzazione.


        I finding vengono restituiti dal più recente al meno recente.
        Facoltativamente, puoi filtrare per ``scan_id``,

        ``repo_name``, ``severity`` e ``status`` (``severity`` e ``status``

        accettano valori multipli); i risultati sono paginati con un cursore
        opaco

        (``after`` / ``first``).
      operationId: >-
        handle_list_code_scan_findings_v3_organizations__org_id__code_scans_findings_get
      parameters:
        - description: 'ID dell''organizzazione (prefisso: org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
        - in: query
          name: after
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: After
        - in: query
          name: first
          required: false
          schema:
            default: 100
            maximum: 200
            minimum: 1
            title: First
            type: integer
        - description: Filtra i finding prodotti da questo scan.
          in: query
          name: scan_id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filtra i finding prodotti da questo scan.
            title: Scan Id
        - description: Filtra i finding segnalati in questo repository.
          in: query
          name: repo_name
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filtra i finding segnalati in questo repository.
            title: Repo Name
        - description: >-
            Filtra i finding con uno qualsiasi di questi livelli di gravità
            (critical, high, medium, low).
          in: query
          name: severity
          required: false
          schema:
            anyOf:
              - items:
                  enum:
                    - critical
                    - high
                    - medium
                    - low
                  type: string
                type: array
              - type: 'null'
            description: >-
              Filtra i finding con uno qualsiasi di questi livelli di gravità
              (critical, high, medium, low).
            title: Severity
        - description: >-
            Filtra i finding con uno qualsiasi di questi stati (open, dismissed,
            resolved).
          in: query
          name: status
          required: false
          schema:
            anyOf:
              - items:
                  enum:
                    - open
                    - dismissed
                    - resolved
                  type: string
                type: array
              - type: 'null'
            description: >-
              Filtra i finding con uno qualsiasi di questi stati (open,
              dismissed, resolved).
            title: Status
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PaginatedResponse_CodeScanFindingResponse_
          description: Risposta corretta
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorizzato
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Accesso negato
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non trovato
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflitto
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenuto non elaborabile
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Troppe richieste
components:
  schemas:
    PaginatedResponse_CodeScanFindingResponse_:
      properties:
        end_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Cursore per recuperare la pagina successiva, oppure None se questa è
            l'ultima pagina.
          title: End Cursor
        has_next_page:
          default: false
          description: Indica se dopo questa pagina sono disponibili altri elementi.
          title: Has Next Page
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/CodeScanFindingResponse'
          title: Items
          type: array
        total:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Conteggio totale facoltativo (può essere omesso per motivi di
            prestazioni).
          title: Total
      required:
        - items
      title: PaginatedResponse[CodeScanFindingResponse]
      type: object
    ProblemDetail:
      description: >-
        Corpo dell'errore application/problem+json RFC 9457 per l'API v3.


        detail è mantenuto dal corpo legacy {"detail": ...} per
        retrocompatibilità; gli

        altri membri sono aggiuntivi. errors contiene gli errori di validazione
        a livello di campo

        (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Una spiegazione leggibile dall'utente, specifica per questa
            occorrenza.
          title: Detail
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errori di convalida a livello di campo (solo per le risposte 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Un riferimento URI (il percorso della richiesta) per questa
            occorrenza.
          title: Instance
        status:
          description: Il codice di stato HTTP.
          title: Status
          type: integer
        title:
          description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
          title: Title
          type: string
        type:
          default: about:blank
          description: Un riferimento URI che identifica il tipo di problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    CodeScanFindingResponse:
      description: Un singolo finding della scansione del codice.
      properties:
        category:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Categoria (nome della regola) in cui è stato classificato il
            finding, se presente.
          title: Category
        code_owners:
          description: Code owner associati al codice interessato.
          items:
            type: string
          title: Code Owners
          type: array
        created_at:
          description: Data e ora di creazione del finding (secondi Unix).
          title: Created At
          type: integer
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Descrizione dettagliata della vulnerabilità, se presente.
          title: Description
        finding_id:
          description: Identificatore univoco del finding.
          title: Finding Id
          type: string
        note:
          anyOf:
            - type: string
            - type: 'null'
          description: Nota aggiuntiva allegata al finding, se presente.
          title: Note
        orchestrator_session_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Sessione dell'orchestratore che ha eseguito la scansione che ha
            prodotto il finding (la sessione Devin della scansione), se
            presente.
          title: Orchestrator Session Id
        pr_url:
          anyOf:
            - type: string
            - type: 'null'
          description: URL della PR di remediation aperta per questo finding, se presente.
          title: Pr Url
        recommendation:
          anyOf:
            - type: string
            - type: 'null'
          description: Remediation suggerita per il finding, se presente.
          title: Recommendation
        reference_snippets:
          description: Frammenti di codice citati dal finding come prove di supporto.
          items:
            $ref: '#/components/schemas/CodeScanReferenceSnippetResponse'
          title: Reference Snippets
          type: array
        related_finding_ids:
          description: >-
            ID dei risultati degli altri collegamenti in una catena di attacco
            realizzata. Impostato solo sul risultato terminale della catena.
          items:
            type: string
          title: Related Finding Ids
          type: array
        repo_name:
          description: Repository in cui è stato segnalato il finding.
          title: Repo Name
          type: string
        scan_id:
          description: Identificatore della scansione che ha prodotto il finding.
          title: Scan Id
          type: string
        session_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Sessione che ha corretto il finding (e ha aperto la PR), se
            presente.
          title: Session Id
        severity:
          description: 'Gravità del finding: critical, high, medium o low.'
          enum:
            - critical
            - high
            - medium
            - low
          title: Severity
          type: string
        status:
          description: 'Stato del finding: open, dismissed o resolved.'
          enum:
            - open
            - dismissed
            - resolved
          title: Status
          type: string
        title:
          anyOf:
            - type: string
            - type: 'null'
          description: Titolo del finding, se presente.
          title: Title
      required:
        - finding_id
        - title
        - description
        - recommendation
        - note
        - code_owners
        - reference_snippets
        - severity
        - category
        - repo_name
        - pr_url
        - scan_id
        - session_id
        - orchestrator_session_id
        - status
        - created_at
      title: CodeScanFindingResponse
      type: object
    CodeScanReferenceSnippetResponse:
      description: Un frammento di codice citato da un finding come prova a supporto.
      properties:
        code:
          anyOf:
            - type: string
            - type: 'null'
          description: Il codice sorgente di riferimento, se acquisito.
          title: Code
        commentary:
          description: >-
            Spiegazione del motivo per cui questo frammento è pertinente al
            finding.
          title: Commentary
          type: string
        end_line:
          description: Ultima riga dell'intervallo di riferimento.
          title: End Line
          type: integer
        file_path:
          description: Percorso del file di riferimento.
          title: File Path
          type: string
        start_line:
          description: Prima riga dell'intervallo di riferimento.
          title: Start Line
          type: integer
      required:
        - file_path
        - start_line
        - end_line
        - commentary
      title: CodeScanReferenceSnippetResponse
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
      scheme: bearer
      type: http

````