---
title: "POST /ListIntegrations"
method: POST
path: "/ListIntegrations"
---

# POST /ListIntegrations

`POST /ListIntegrations`

Lists the integrations in your account, optionally filtered by provider or provider type.

## Request body

- object
  - `filter` object — A filter for listing integrations. This is a union type where you can filter by provider or provider type.
    - `provider` 'GITHUB' | 'GITLAB' | 'BITBUCKET' | 'CONFLUENCE' — Filter integrations by provider.
    - `providerType` 'SOURCE_CODE' | 'DOCUMENTATION' — Filter integrations by provider type.
  - `nextToken` string — Pagination token.
  - `maxResults` integer — Maximum results for pagination.

## Response `200`

Success

- ListIntegrationsOutput
  - `integrationSummaries` IntegrationSummary[], required — The list of integration summaries.
    - `integrationId` string, required — The unique identifier of the integration.
    - `installationId` string, required — The installation identifier from the integration provider.
    - `provider` 'GITHUB' | 'GITLAB' | 'BITBUCKET' | 'CONFLUENCE', required — The integration provider.
    - `providerType` 'SOURCE_CODE' | 'DOCUMENTATION', required — The type of the integration provider.
    - `displayName` string, required — The display name of the integration.
    - `targetUrl` string — The HTTPS URL of the customer self-hosted instance, such as a GitHub Enterprise Server or self-managed GitLab instance. This value is absent for SaaS integrations.
    - `privateConnectionName` string — The name of the private connection used to reach the integration's self-hosted instance over private networking, if one is configured.
  - `nextToken` string — A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)