---
title: "Get a connection"
method: GET
path: "/connections/{id}"
tags: ["Connections"]
---

# Get a connection

`GET /connections/{id}`

## Request

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

Returns a single connection by ID, with the latest captured audience metrics.

## Path parameters

- `id` string, required

## Response `200`

Response for status 200

- object
  - `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

## Other responses

- `404`: Response for status 404

---

[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)
