---
title: "List connections"
method: GET
path: "/connections"
tags: ["Connections"]
---

# List connections

`GET /connections`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/connections`
- Auth: API key in header `X-Api-Key`

Returns the active social connections in this workspace — the IDs you pass as `connection_id` when creating a post. Each entry includes the platform, public profile info (username, avatar, bio) and the latest captured audience metrics (followers, posts, likes). Revoked or disconnected accounts are excluded.

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 50, max: 100)
- `platform` 'youtube' | 'tiktok' | 'instagram' | 'bluesky' | 'threads' | 'linkedin' | 'pinterest' | 'facebook' | 'twitch' | 'kick' | 'discord'

## Response `200`

Response for status 200

- object
  - `connections` object[], required
    - `id` string, required
    - `platform` string, required: Source platform, e.g. `youtube`, `tiktok`, `instagram`, `bluesky`, `threads`, `linkedin`, `pinterest`, `facebook`
    - `username` string, nullable, required
    - `avatar_url` string, nullable, required
    - `biography` string, nullable, required
    - `followers_count` number, nullable, required
    - `posts_count` number, nullable, required
    - `likes_count` number, nullable, required
    - `is_verified` boolean, nullable, required
    - `created_at` string, nullable, required
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)