# List integrations

> Every integration the workspace can use, optionally ranked by a search query.

Source: https://docs.generalinput.com/api/integrations/list



<Endpoint method="GET" path="/v1/integrations" />

<Access scope="docs:read" />

Lists the integrations available to the workspace. Visibility follows the workspace type: development workspaces also see integrations that are still in development.

## Query parameters [#query-parameters]

| Name | Type   | Notes                                                                                                                                                                                    |
| ---- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`  | string | Optional. Server-side hybrid search (semantic plus lexical) over slug, title, and description. Ranked when present. Search by capability ("calendar", "send message"), not only by name. |

## Response [#response]

```json
{
  "integrations": [
    {
      "service": "slack",
      "title": "Slack",
      "description": "Send messages, react to events, and read history.",
      "credentialType": "oauth2"
    },
    {
      "service": "search-internet",
      "title": "Internet Search",
      "description": "Search the web for real-time results.",
      "credentialType": "platform"
    }
  ]
}
```

| Field            | Type   | Notes                                            |
| ---------------- | ------ | ------------------------------------------------ |
| `service`        | string | The slug every other route and the vault key on. |
| `title`          | string | Display name.                                    |
| `description`    | string | One-line summary.                                |
| `credentialType` | string | `oauth2`, `apiKey`, `platform`, or `noAuth`.     |

## Example [#example]

```sh
curl -s "https://cloud.generalinput.com/v1/integrations?q=calendar" \
  -H "Authorization: Bearer $GI_API_KEY"
```