> ## 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. # Obtener un finding > Un finding, de cualquier familia, con su estado de triaje, el recuento y las fechas de sus detecciones y su detección más reciente. El token necesita el mismo permiso de visualización que la lista de incidencias (issues) de la familia. ## OpenAPI ````yaml /es/api-reference/openapi.json get /findings/{finding_id} openapi: 3.0.0 info: title: API de Corgea version: 1.0.0 description: >- API para interactuar con las funciones de escaneo y gestión de vulnerabilidades de Corgea servers: - url: https://www.corgea.app/api/v1 description: Servidor de producción - url: https://eu.corgea.app/api/v1 description: Servidor de producción de la UE security: - CorgeaToken: [] - BearerAuth: [] paths: /findings/{finding_id}: get: tags: - Findings summary: Obtener un finding description: >- Un finding, de cualquier familia, con su estado de triaje, el recuento y las fechas de sus detecciones y su detección más reciente. El token necesita el mismo permiso de visualización que la lista de incidencias (issues) de la familia. operationId: getFinding parameters: - name: finding_id in: path required: true schema: type: string format: uuid description: >- ID del finding, tal como aparece en finding_id en los elementos de incidencia (issue) responses: '200': description: Finding obtenido correctamente content: application/json: schema: type: object properties: status: type: string example: ok finding: $ref: '#/components/schemas/Finding' '403': description: >- El token no tiene permiso para ver una de las familias de findings solicitadas '404': description: No hay ningún finding accesible con este id components: schemas: Finding: type: object description: >- Una vulnerabilidad en un proyecto a lo largo de todos los escaneos que la detectaron. Su id se mantiene estable entre reescaneos, ramas y migraciones de huellas digitales; el triaje vive aquí y se refleja en cada una de sus detecciones (incidencias). 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 mientras el finding tiene una detección en su proyecto; retired cuando su última detección se eliminó junto con su escaneo o su proyecto. Un finding que un reescaneo ya no reporta sigue active con estado fixed. Null hasta que el índice de findings de la cuenta esté completo. 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: >- Cuándo cambió el estado por última vez; fíltralo con status_changed_since. status_changed_by: allOf: - $ref: '#/components/schemas/AssignedTo' nullable: true description: Usuario que hizo el último cambio de estado, o 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 detección más antigua. last_detection_date: type: string format: date-time nullable: true description: created_at de la detección más reciente. detections_count: type: integer description: Cuántas detecciones tiene el finding entre todos los escaneos. latest_detection: allOf: - $ref: '#/components/schemas/FindingLatestDetection' nullable: true description: >- La detección más reciente del finding: su id es el que aceptan los endpoints de incidencias (issues), e incluye el localizador propio de la familia. AssignedTo: type: object nullable: true description: >- Usuario asignado al hallazgo, o null cuando el hallazgo no está asignado. properties: id: type: string description: ID del usuario asignado. email: type: string format: email description: Dirección de correo electrónico del usuario asignado. name: type: string nullable: true description: >- Nombre para mostrar del usuario asignado, o null si no está disponible. FindingLatestDetection: type: object properties: id: type: string format: uuid description: >- ID de la detección (incidencia), para /issue/{issue_id} y /issues/sca/{issue_id}. scan_id: type: string format: uuid nullable: true description: >- Escaneo al que pertenece la detección; null en una detección SAST ingerida sin escaneo. branch: type: string nullable: true sha: type: string nullable: true created_at: type: string format: date-time file_path: type: string description: Solo findings SAST, de secretos, de lógica y de calidad de código. line_number: type: integer nullable: true description: Solo findings SAST, de secretos, de lógica y de calidad de código. path: type: string description: Solo findings de dependencias, contenedores e IaC. package: type: string description: Solo findings de dependencias y contenedores. version: type: string description: Solo findings de dependencias y contenedores. cve: type: string nullable: true description: Solo findings de dependencias y contenedores. rule_id: type: string description: Solo findings de IaC. start_line: type: integer nullable: true description: Solo findings de IaC. end_line: type: integer nullable: true description: Solo findings de IaC. securitySchemes: CorgeaToken: type: apiKey in: header name: CORGEA-TOKEN description: >- Clave de API para la autenticación Se rechazan los tokens de API de usuarios inactivos. BearerAuth: type: http scheme: bearer bearerFormat: JWT description: Token de acceso OAuth2 (JWT) en el encabezado Authorization ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.