> ## 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行を返します。ファインディングは、1つのプロジェクトにおける脆弱性を、それを検出したすべてのスキャンにまたがって表したもので、トリアージ状態と最新の検出を含みます。初めて検出された日時の新しい順に並び、同じ日時の結果はIDで順序を決めるため、ページ分割時も順序が安定します。アカウントのファインディングインデックスの構築が完了するまでは404を返します。 ## OpenAPI ````yaml /ja/api-reference/openapi.json get /findings 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: get: tags: - Findings summary: ファインディングを一覧表示 description: >- ファインディングごとに1行を返します。ファインディングは、1つのプロジェクトにおける脆弱性を、それを検出したすべてのスキャンにまたがって表したもので、トリアージ状態と最新の検出を含みます。初めて検出された日時の新しい順に並び、同じ日時の結果はIDで順序を決めるため、ページ分割時も順序が安定します。アカウントのファインディングインデックスの構築が完了するまでは404を返します。 operationId: listFindings parameters: - name: issue_type in: query required: false schema: type: string example: sast,dependency description: >- 種別をカンマ区切りで指定します。デフォルトはトークンが表示できるすべてのセキュリティ種別(code_qualityを除く)です。表示権限のない種別を指定すると403を返します。 - name: status in: query required: false schema: type: string example: open,fix_in_progress description: ステータスをカンマ区切りで指定します。 - name: urgency in: query required: false schema: type: string example: CR,HI description: 緊急度をカンマ区切りで指定します。 - name: project_id in: query required: false schema: type: string example: 12,15 description: プロジェクトIDをカンマ区切りで指定します。 - name: project in: query required: false schema: type: string description: プロジェクト名を1件指定します。 - name: repo in: query required: false schema: type: string description: リポジトリURLの部分文字列を指定します。 - name: cwe in: query required: false schema: type: string example: CWE-79,CWE-89 description: CWE識別子をカンマ区切りで指定します。CWE-79または79の形式で指定できます。 - name: detection_state in: query required: false schema: type: string enum: - active - retired - all default: active description: >- active:プロジェクト内に検出が存在するファインディング(デフォルト)。retired:最後の検出がスキャンまたはプロジェクトとともに削除されたファインディング。all:両方。 - name: status_changed_since in: query required: false schema: type: string example: '2026-10-01T00:00:00Z' description: >- ISO 8601形式の日時、または日付(UTCの午前0時として解釈)を指定します。この時点より後にトリアージが変更されたファインディングを返します。増分同期に使用してください。 - name: created_since in: query required: false schema: type: string example: '2026-10-01T00:00:00Z' description: >- ISO 8601形式の日時、または日付(UTCの午前0時として解釈)を指定します。この時点より後に初めて検出されたファインディングを返します。 - name: assigned_to in: query required: false schema: type: integer description: ユーザーIDを1件指定します。 - name: sort_by in: query required: false schema: type: string enum: - '-created_at' - created_at - urgency - '-urgency' - status - '-status' - status_changed_at - '-status_changed_at' default: '-created_at' description: >- 並べ替え順を指定します。created_atはファインディングが初めて検出された日時で、created_sinceが絞り込みに使う値と同じです。レスポンスには含まれず、ファインディングの最も古い検出がスキャンとともに削除されていない限り、first_detection_dateと一致します。並べ替えの値が同じ場合は、IDで順序を決めます。 - name: page in: query required: false schema: type: integer default: 1 description: ページネーションのページ番号 - name: page_size in: query required: false schema: type: integer default: 20 maximum: 100 description: 1ページあたりの結果件数 responses: '200': description: ファインディングを正常に取得しました content: application/json: schema: type: object properties: status: type: string example: ok page: type: integer total_pages: type: integer total_findings: type: integer findings: type: array items: $ref: '#/components/schemas/Finding' '400': description: パラメーターの値が無効です '403': description: トークンに、指定したファインディング種別を表示する権限がありません '404': description: アカウントのファインディングインデックスの構築がまだ完了していません 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.