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

# List all connected social accounts

`GET /accounts`

## Request

- Base URL: `https://socialrobot.io/api/v1`
- URL: `https://socialrobot.io/api/v1/accounts`
- Auth: API key in header `x-api-key`

Returns the connected social accounts available to the authenticated user across every supported platform.

## Response `200`

Connected accounts fetched successfully

- object[]
  - `id` string, required: Internal account ID used by the API
  - `platform` 'instagram' | 'pinterest' | 'x' | 'linkedin' | 'bluesky' | 'tiktok' | 'mastodon' | 'threads' | 'facebook', required: The connected social platform
  - `handle` string, nullable, required: Platform handle, username, or page identifier
  - `displayName` string, nullable, required: Human-readable account or page name
  - `profileImage` string, nullable, required: Profile image or avatar URL when available
  - `externalAccountId` string, nullable, required: Platform-native account identifier
  - `expiresAt` string, nullable, required: Token expiration date when the integration tracks one

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

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