---
title: "List teams with access to a secret incident"
method: GET
path: "/v1/secret-incidents/{incident_id}/teams"
tags: ["Internal Secret Incidents"]
---

# List teams with access to a secret incident

`GET /v1/secret-incidents/{incident_id}/teams`

## Request

- Base URL: `https://api.gitguardian.com`
- URL: `https://api.gitguardian.com/v1/secret-incidents/{incident_id}/teams`
- Auth: HTTP bearer

List teams that have access to a secret incident.

## Path parameters

- `incident_id` integer, required

## Query parameters

- `cursor` string
- `per_page` integer
- `search` string: Search teams based on their name and/or description.
- `direct_access` boolean

## Response `200`

List teams

- object[]
  - `id` integer
  - `name` string
  - `description` string, nullable: team description.
  - `is_global` boolean
  - `gitguardian_url` string
  - `external_provider_id` string, nullable: ID of the external provider associated to the team.
  - `external_provider_type` string, nullable: Type of the external provider associated to the team.

## Other responses

- `400`: Invalid data
- `401`: Invalid API key
- `403`: Permission denied
- `404`: Secret Incident not found
- `503`: API under maintenance

## Changes

- **2026-09-10** `9ae1cffd3970`: 1 info
  - added the optional property `items/external_provider_type` to the response with the `200` status

[Operation history](https://skmtc.dev/gitguardian/apis/gitguardian-api/changes/v1/secret-incidents/:incident_id/teams/get.md)

---

[API](https://skmtc.dev/gitguardian/apis/gitguardian-api.md) - [All operations](https://skmtc.dev/gitguardian/apis/gitguardian-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitguardian/apis/gitguardian-api/revisions/5829df7b9045?raw)