---
title: "Get account details"
method: GET
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Get account details

`GET /accounts/{id}`

## Path parameters

- `id` string, required

## Response `200`

Account details

- object
  - `data` Account
    - `id` string — Account ID (use this when creating posts)
    - `platform` 'instagram' | 'facebook' | 'linkedin' | 'linkedin_page' | 'youtube' | 'tiktok' | 'pinterest' | 'bluesky' | 'threads' | 'mastodon' | 'x' | 'google_business' | 'reddit' | 'snapchat'
    - `username` string — Social media username/handle
    - `display_name` string — Display name on the platform
    - `profile_picture` string — Profile picture URL
    - `content_types` string[] — Supported content types for this platform
    - `status` 'active' | 'needs_reconnect' — Connection status. `needs_reconnect` means the account is still wired up to the workspace but its OAuth token has been revoked or expired; posts to this account will fail until the user reconnects in the OmniSocials UI. Most often caused by the user changing their password, deauthorizing OmniSocials on the platform, or the token expiring without a successful refresh.
    - `needs_reconnect` boolean — Convenience boolean — `true` when `status` is `needs_reconnect`.
    - `reauth_reason` string, nullable — Short reason from the platform (e.g. "OAuthException: Session has expired"). Present only when `needs_reconnect` is true. Token-health tracking exists for Instagram, Facebook, Threads, X, Pinterest, LinkedIn (profile + page); other platforms always report `needs_reconnect: false`.
    - `boards` object[] — Pinterest boards (only present for Pinterest accounts). Use board `id` as `board_id` when creating Pinterest posts.
      - `id` string — Board ID (use as board_id when creating posts)
      - `name` string — Board name
    - `platform_details` object — Platform-specific details. Present for X accounts with Premium subscription.
      - `subscription_type` string — X subscription tier (e.g. "Premium", "PremiumPlus")
    - `connected_at` string, date-time

## Other responses

- `404` — Account not found

---

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