---
title: "Retrieve the impacted perimeter of a secret incident"
method: GET
path: "/v1/incidents/secrets/{incident_id}/impacted_perimeter"
tags: ["Internal Secret Incidents"]
---

# Retrieve the impacted perimeter of a secret incident

`GET /v1/incidents/secrets/{incident_id}/impacted_perimeter`

Retrieve metrics about the impacted perimeter of a secret incident detected by the GitGuardian dashboard.

## Path parameters

- `incident_id` integer, required

## Response `200`

Secret Incident Impacted Perimeter

- object
  - `id` integer
  - `status` 'IGNORED' | 'TRIGGERED' | 'ASSIGNED' | 'RESOLVED'
  - `secret_presence` object
    - `files_requiring_code_fix` integer
    - `files_pending_merge` integer
    - `files_fixed` integer
    - `outside_vcs` integer
    - `removed_outside_vcs` integer
    - `in_vcs` integer
    - `removed_in_vcs` integer
  - `sources` object[]
    - `id` integer
    - `url` string — URL of the source. Empty for sources without a URL, such as non-VCS or deleted sources.
    - `type` 'gh_repository' | 'ghe_repository' | 'gl_project' | 'bb_repository' | 'bb_cloud_repository' | 'ado_repository' | 'gerrit_repository' | 'slack_channel' | 'jira_cloud_project' | 'confluence_cloud_space' | 'microsoft_teams_channel' | 'confluence_data_center_space' | 'jira_data_center_project' | 'servicenow_table' | 'google_artifact_repository' | 'docker_hub_repository' | 'jfrog_artifact_repository' | 'azure_cr_repository' | 'aws_ecr_repository' | 'red_hat_quay_repository' | 'sharepoint_online_drive' | 'sharepoint_online_pages' | 'microsoft_onedrive' | 'aws_s3_bucket' | 'custom_source' | 'endpoints' | 'jfrog_package' | 'jfrog_container_registry_v2_repository'
    - `full_name` string
    - `files` object
      - `files_requiring_code_fix` object[]
        - `filepath` string
        - `mentions_count` integer
        - `file_url` string — URL of the file. Empty when the source has no URL, such as non-VCS or deleted sources.
      - `files_pending_merge` object[]
        - `filepath` string
        - `mentions_count` integer
        - `file_url` string — URL of the file. Empty when the source has no URL, such as non-VCS or deleted sources.
      - `files_fixed` object[]
        - `filepath` string
        - `mentions_count` integer
        - `merge_request_url` string

## Other responses

- `400` — Invalid data
- `401` — Invalid API key
- `503` — API under maintenance

---

[API](https://skmtc.net/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.net/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitguardian/gitguardian-api/revisions/511b067cdcb1/schema)