---
title: "Get social accounts"
method: GET
path: "/v1/social-accounts"
tags: ["Social Accounts"]
---

# Get social accounts

`GET /v1/social-accounts`

Get a paginated result for social accounts based on the applied filters

## Query parameters

- `offset` number
- `limit` number
- `platform` string[]
- `username` string[]

## Response `200`

Paginated data set for social accounts.

- object
  - `data` SocialAccountDto[], required
    - `id` number, required — The unique identifier of the social account
    - `platform` string, required — The platform of the social account
    - `username` string, required — The platform's username of the social account
    - `needs_reconnect` boolean, required — True when repeated dead-token failures have paused posting to this account (Meta platforms). Posts to it are skipped until the account is reconnected in the dashboard; any reconnect clears it automatically. Pause your automation for accounts in this state instead of retrying.
  - `meta` object, required
    - `total` number, required — Total number of items available.
    - `offset` number, required — Number of items skipped.
    - `limit` number, required — Maximum number of items returned.
    - `next` string, nullable, required — URL to the next page of results, or null if none.

## Other responses

- `500` — Internal server error when fetching social accounts.

---

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