---
title: "List connected social accounts"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List connected social accounts

`GET /v1/accounts`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/accounts`
- Auth: HTTP bearer

Returns every social account (Twitter/X, Threads, Bluesky, LinkedIn, Facebook, Instagram, YouTube, TikTok) connected across all the user's content groups.

## Response `200`

Array of connected accounts.

- object
  - `success` true, required
  - `data` object, required
    - `accounts` object[], required
      - `id` string, required
      - `app_id` string, required
      - `platform` string, required
      - `account_name` string, nullable, required
      - `token_status` 'valid' | 'expired' | 'reconnect_required' | 'unknown': Connection-health of the social account. `valid` = token worked recently; `reconnect_required` = the platform returned an auth error; `expired` = the token's stored `expires_at` is in the past; `unknown` = no recent signal (either never validated or last validation is >14 days stale).
      - `last_validated_at` string, date-time, nullable: ISO timestamp of the most recent token validation (success or known failure).
      - `last_validation_error` string, nullable: Most recent auth-error message returned by the platform, if any.
      - `follower_count` number, nullable: Current follower count for this account, as of `followers_fetched_at`. Null when the platform does not expose this (X v2 free tier, LinkedIn personal profiles, YouTube channels with hidden subscriber count).
      - `following_count` number, nullable: Current following count, where the platform exposes it.
      - `followers_fetched_at` string, date-time, nullable: ISO timestamp of the most recent follower-count snapshot.
      - `created_at` string, date-time

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)