---
title: "Get social media accounts for a workspace"
method: GET
path: "/api/v1/workspaces/{workspace_id}/accounts"
tags: ["📱 Social Accounts"]
---

# Get social media accounts for a workspace

`GET /api/v1/workspaces/{workspace_id}/accounts`

Retrieve paginated list of social media accounts for a specific workspace with optional platform filtering

## Path parameters

- `workspace_id` string, required

## Query parameters

- `platform` 'facebook' | 'twitter' | 'linkedin' | 'pinterest' | 'instagram' | 'gmb' | 'youtube' | 'tiktok' | 'tumblr' | 'threads' | 'bluesky' | 'telegram'
- `search` string
- `page` integer
- `per_page` integer

## Response `200`

Accounts retrieved successfully

- object
  - `status` boolean
  - `message` string
  - `current_page` integer
  - `per_page` integer
  - `total` integer
  - `last_page` integer
  - `from` integer
  - `to` integer
  - `data` object[]
    - `id` string — Platform-specific account identifier
    - `_id` string — Deprecated alias for `id` — will be removed once clients migrate.
    - `platform` 'facebook' | 'twitter' | 'linkedin' | 'pinterest' | 'instagram' | 'gmb' | 'youtube' | 'tiktok' | 'tumblr' | 'threads' | 'bluesky' | 'telegram'
    - `account_name` string
    - `profile_picture` string
    - `status` string
    - `connected_at` string, date-time
    - `expires_at` string, date-time

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `404` — Workspace not found or access denied
- `429` — Too Many Requests - Rate limit exceeded

---

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