---
title: "GET /v1/app-connections"
method: GET
path: "/v1/app-connections"
tags: ["app-connections"]
---

# GET /v1/app-connections

`GET /v1/app-connections`

List app connections

## Query parameters

- `cursor` string
- `projectId` string, required
- `scope` union
  - 'PROJECT'
  - 'PLATFORM'
- `pieceName` string
- `displayName` string
- `status` union[]
  - union
    - 'ACTIVE'
    - 'ERROR'
- `limit` number

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `externalId` string, required
    - `displayName` string, required
    - `type` union, required
      - 'OAUTH2'
      - 'PLATFORM_OAUTH2'
      - 'CLOUD_OAUTH2'
      - 'SECRET_TEXT'
      - 'BASIC_AUTH'
      - 'CUSTOM_AUTH'
    - `pieceName` string, required
    - `projectIds` string[], required
    - `platformId` string, nullable
    - `scope` union, required
      - 'PROJECT'
      - 'PLATFORM'
    - `status` union, required
      - 'ACTIVE'
      - 'ERROR'
    - `ownerId` string, nullable
    - `owner` object, nullable
      - `id` string, required
      - `email` string, required
      - `firstName` string, required
      - `status` union, required
        - 'ACTIVE'
        - 'INACTIVE'
      - `externalId` string, nullable
      - `platformId` string, nullable
      - `platformRole` union, required
        - 'ADMIN'
        - 'MEMBER'
      - `lastName` string, required
      - `created` string, required
      - `updated` string, required
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2025-01-09** `92e8f2eba0ee` — 4 info
  - added the optional property `data/items/owner/externalId` to the response with the `200` status
  - added the required property `data/items/owner/created` to the response with the `200` status
  - added the required property `data/items/owner/status` to the response with the `200` status
  - added the required property `data/items/owner/updated` to the response with the `200` status
- **2024-11-25** `086c2138cb1b` — 1 info
  - added the new optional `query` request parameter `scope`
- **2024-11-12** `499ae054e9e9` — 2 breaking, 1 warning, 8 info
  - removed the required property `data/items/name` from the response with the `200` status
  - removed the required property `data/items/projectId` from the response with the `200` status
  - deleted the `query` request parameter `name`
  - added the new optional `query` request parameter `displayName`
  - …7 more
- **2024-09-13** `225ff954244e` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2024-08-14** `ed47604969c3` — 1 info
  - added the new optional `query` request parameter `status`

[Full history](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/changes/v1/app-connections/get.md)

---

[API](https://skmtc.dev/activeboxes/apis/activeboxes-documentation.md) · [All operations](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activeboxes/activeboxes-documentation/revisions/12c564515962/schema)