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

# List Integrations

`GET /api/v1/integration/integrations`

This endpoint will return all the integrations active in your workspace.

## Query parameters

- `type` string

## Response `200`

List of integrations.

- object
  - `links` object — Indicates Links to associated pages.
    - `next` string — The link to the next page (null if there are no more pages).
    - `previous` string — The link to the previous page (null if on the first page).
  - `meta` object — Reprents the meta data of the response.
    - `page` integer — The current page number.
    - `previous_page` integer — The previous page number (null if on the first page).
    - `next_page` integer — The next page number (null if on the last page).
  - `count` integer — The total count of items returned.
  - `total_pages` integer — The total number of pages.
  - `results` V1IntegrationResponse[]
    - `id` string — The ID of the created integration.
    - `created_at` string, date-time — The timestamp when the integration was created in Secoda in UTC format.
    - `updated_at` string, date-time — The timestamp when the integration was last updated in Secoda UTC format.
    - `name` string — The name of the integration.
    - `type` string — The type of integration.
    - `credentials` object — The actual credentials of the integration will NOT be returned. Can you find the easter egg in this response parameter for native integrations?
    - `workspace_id` string — The ID of the associated workspace.
    - `ssh_tunnel` string — Information about SSH tunnel if one is set update.
    - `execute_access` string[] — List of IDs that have the permission to trigger the extracton.
    - `scheduled_extractions_hour` integer — Hour for scheduled extractions. Will be null for custom extractions.
    - `scheduled_extractions_frequency` integer — Frequency in days of scheduled extractions. Will be null for custom extractions.
    - `scheduled_extractions_next_run` string, date-time — Next scheduled extraction run time. Will be null for custom extractions.
    - `scheduled_extractions_last_run` string — Last scheduled extraction run time (null in this response).
    - `properties` object — Additional properties associated with the integration.
    - `preview_access_users` string[] — List of users IDs with access to preview the data in the integration.
    - `preview_access_roles` string[] — List of roles that are allowed to preview the data in the integration. <ul><li> Admin <li> Editor <li> Viewer </ul>
    - `preview_access_groups` string[] — List of users group IDs with access to preview the data in the integration.
    - `teams` string[] — List of team IDs associated with the integration.

## Other responses

- `400` — Bad request.
- `500` — Internal server error.

---

[API](https://skmtc.dev/secoda/apis/secoda-api.md) · [All operations](https://skmtc.dev/secoda/apis/secoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/secoda/secoda-api/revisions/e6d760bd7a94/schema)