> ## 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.

# ファインディングを取得

> 任意の種別のファインディングを1件返します。トリアージ状態、検出の件数と日付、最新の検出を含みます。トークンには、その種別の問題一覧と同じ表示権限が必要です。



## OpenAPI

````yaml /ja/api-reference/openapi.json get /findings/{finding_id}
openapi: 3.0.0
info:
  title: Corgea API
  version: 1.0.0
  description: Corgeaのスキャン機能および脆弱性管理機能を操作するためのAPI
servers:
  - url: https://www.corgea.app/api/v1
    description: 本番サーバー
  - url: https://eu.corgea.app/api/v1
    description: EU本番サーバー
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /findings/{finding_id}:
    get:
      tags:
        - Findings
      summary: ファインディングを取得
      description: >-
        任意の種別のファインディングを1件返します。トリアージ状態、検出の件数と日付、最新の検出を含みます。トークンには、その種別の問題一覧と同じ表示権限が必要です。
      operationId: getFinding
      parameters:
        - name: finding_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ファインディングID。問題項目のfinding_idと同じ値です
      responses:
        '200':
          description: ファインディングを正常に取得しました
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  finding:
                    $ref: '#/components/schemas/Finding'
        '403':
          description: トークンに、指定したファインディング種別を表示する権限がありません
        '404':
          description: このIDに一致するアクセス可能なファインディングがありません
components:
  schemas:
    Finding:
      type: object
      description: >-
        1つのプロジェクトにおける脆弱性を、それを検出したすべてのスキャンにまたがって表したものです。IDは再スキャン、ブランチ、フィンガープリントの移行を経ても変わりません。トリアージ情報はここに保持され、各検出(問題)に反映されます。
      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、最後の検出がスキャンまたはプロジェクトとともに削除されるとretiredになります。再スキャンで報告されなくなったファインディングはactiveのまま、ステータスがfixedになります。アカウントのファインディングインデックスの構築が完了するまではnullです。
        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: ステータスが最後に変更された日時。status_changed_sinceで絞り込めます。
        status_changed_by:
          allOf:
            - $ref: '#/components/schemas/AssignedTo'
          nullable: true
          description: ステータスを最後に変更したユーザー。未変更の場合は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。
        last_detection_date:
          type: string
          format: date-time
          nullable: true
          description: 最新の検出のcreated_at。
        detections_count:
          type: integer
          description: スキャン横断でこのファインディングが持つ検出の件数。
        latest_detection:
          allOf:
            - $ref: '#/components/schemas/FindingLatestDetection'
          nullable: true
          description: このファインディングの最新の検出。そのIDは問題エンドポイントが受け取るIDで、種別ごとの位置情報を含みます。
    AssignedTo:
      type: object
      nullable: true
      description: 問題の担当ユーザー。未割り当ての場合はnullです。
      properties:
        id:
          type: string
          description: 担当ユーザーのID。
        email:
          type: string
          format: email
          description: 担当ユーザーのメールアドレス。
        name:
          type: string
          nullable: true
          description: 担当ユーザーの表示名。利用できない場合はnullです。
    FindingLatestDetection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: 検出(問題)のID。/issue/{issue_id}や/issues/sca/{issue_id}に指定します。
        scan_id:
          type: string
          format: uuid
          nullable: true
          description: 検出が属するスキャン。スキャンなしで取り込まれたSASTの検出ではnullです。
        branch:
          type: string
          nullable: true
        sha:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        file_path:
          type: string
          description: SAST、シークレット、ロジック、コード品質のファインディングのみ。
        line_number:
          type: integer
          nullable: true
          description: SAST、シークレット、ロジック、コード品質のファインディングのみ。
        path:
          type: string
          description: 依存関係、コンテナ、IaCのファインディングのみ。
        package:
          type: string
          description: 依存関係とコンテナのファインディングのみ。
        version:
          type: string
          description: 依存関係とコンテナのファインディングのみ。
        cve:
          type: string
          nullable: true
          description: 依存関係とコンテナのファインディングのみ。
        rule_id:
          type: string
          description: IaCのファインディングのみ。
        start_line:
          type: integer
          nullable: true
          description: IaCのファインディングのみ。
        end_line:
          type: integer
          nullable: true
          description: IaCのファインディングのみ。
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: 認証用のAPIキー 無効なユーザーのAPIトークンは拒否されます。
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Authorizationヘッダーで使用するOAuth2アクセストークン（JWT）

````

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