---
title: "List Integrations"
method: GET
path: "/api/v1/integrations"
tags: ["Integrations"]
---

# List Integrations

`GET /api/v1/integrations`

## Request

- Base URL: `https://public-api.linearb.io`
- URL: `https://public-api.linearb.io/api/v1/integrations`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/linearb/apis/linearb-api/docs/api/v1/integrations/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the organization's PM and git integrations - live ones by default

## Query parameters

- `type` 'pm' | 'git': The integration type, `pm` or `git`. Omitted lists both
- `provider` string, nullable: Only these providers, comma-separated, e.g. `github,jira`
- `include_invalid` boolean: Also list deleted integrations

## Response `200`

Successful Response

- IntegrationsResponseModel
  - `items` IntegrationModel[], required
    - `id` integer, required: The integration id. PM integration ids are what the PM configuration endpoints take; git integration ids are what the git repository endpoints take
    - `type` 'pm' | 'git', required: `pm` or `git`
    - `provider` 'jira' | 'azure_boards' | 'bitbucket' | 'gitlab' | 'github' | 'bitbucket_server' | 'azure_devops', required: `jira` or `azure_boards` for PM; `github`, `gitlab`, `bitbucket`, `bitbucket_server` or `azure_devops` for git
    - `name` string, nullable: The integration display name
    - `state` string, nullable: The integration state, e.g. `ok`, `failing`, `in-progress`
    - `auth_type` string, nullable: How the integration is connected
    - `failing_reason` string, nullable: Why the integration is failing, in the Health Center wording. Present only when it has one
    - `deleted_at` string, nullable: When the integration was deleted. Present only under `include_invalid=true`

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `409`: Conflict
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

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