---
title: "Retrieve a social account"
method: GET
path: "/v1/social-accounts/{id}"
tags: ["Social Accounts"]
---

# Retrieve a social account

`GET /v1/social-accounts/{id}`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/social-accounts/{id}`
- Auth: `bearerAuth` (a scheme the document does not define)

One connected account by id. Same shape as a row in the list, so anything holding an acc_… can ask about it directly instead of paging the list and filtering.

## Path parameters

- `id` string, required

## Response `200`

Success

- SocialAccount
  - `id` string, required
  - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required
  - `handle` string, required
  - `profileId` string, nullable, required
  - `status` string, required
  - `avatarUrl` string, nullable
  - `connectVariant` string: Which door this account was connected through, for networks that have more than one. Instagram is the case: `instagram` means Instagram Login, `facebook` means it was connected through a Facebook Page. The two reach genuinely different feature sets, so this decides what the account can do. Absent on networks with a single way in.
  - `accountType` 'BUSINESS' | 'MEDIA_CREATOR' | 'PERSONAL', nullable: Instagram account type when known. Stories support both login routes, subject to Meta account eligibility. Facebook Login Stories require a Business account. Null means the type is unknown; Meta enforces eligibility during publishing.
  - `discovers` object, required: What this ACCOUNT can search, as opposed to GET /v1/platforms/{platform}, which can only speak for the network as a whole. An Instagram connected by Instagram Login cannot search creators or hashtags however the platform-level flags read, so check here before calling a discovery endpoint rather than learning it from an error.
    - `posts` boolean, required
    - `profiles` boolean, required
    - `profilePosts` boolean, required
    - `places` boolean, required
    - `creators` boolean, required: True only when the connection can reach its creator-discovery product. A true still leaves the network's own onboarding to be done: Meta refuses the search with `creator_marketplace_not_onboarded` until the brand has accepted the relevant terms.
  - `requires` string, nullable: What this network needs before it will publish, in one sentence (media requirements, title and caption limits). Read it before composing: TikTok, Instagram, YouTube and Pinterest all refuse text-only posts. Null when the network accepts anything.

## Other responses

- `401`: Unauthorized
- `404`: Unknown connected account

---

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