# List Social Accounts

> Retrieve connected social accounts for your workspace

- **URL**: https://orshot.com/docs/api-reference/social-accounts-list

---

List all connected social media accounts in your workspace. Use this to find account IDs for the [`publish`](https://orshot.com/docs/publish/publish-from-api) parameter when rendering templates, or for the [Publish to Social](https://orshot.com/docs/api-reference/social-publish) endpoint.

You can also find account IDs in your dashboard under **Social Accounts** in the workspace sidebar — each account displays its ID with a **Copy ID** button.

## Endpoint

### GET /social/accounts```markdown tab="Endpoint"
https://api.orshot.com/v1/social/accounts
```## Request Example```js
await fetch("https://api.orshot.com/v1/social/accounts", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```### With Account Health

Pass `include_health=true` to check if any accounts need reconnection (e.g., expired tokens).```js
await fetch("https://api.orshot.com/v1/social/accounts?include_health=true", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```## Response Example```json
{
  "data": [
    {
      "id": 1,
      "platform": "twitter",
      "account_name": "Acme HQ",
      "account_username": "acmehq",
      "account_avatar": "https://pbs.twimg.com/profile_images/.../avatar.jpg",
      "connected_at": "2026-03-15T10:30:00.000Z"
    },
    {
      "id": 2,
      "platform": "linkedin",
      "account_name": "Acme Inc",
      "account_username": "acme-inc",
      "account_avatar": "https://media.licdn.com/.../avatar.jpg",
      "connected_at": "2026-03-16T14:00:00.000Z"
    }
  ]
}
```## Response Fields

| Field                | Type    | Description                                                              |
| -------------------- | ------- | ------------------------------------------------------------------------ |
| `id`                 | Integer | Account ID — use this in the `publish.accounts` array                    |
| `platform`           | String  | Platform name (`twitter`, `instagram`, `linkedin`, `facebook`, `tiktok`, `youtube`, `pinterest`, `reddit`, `bluesky`, `threads`, `telegram`, `snapchat`, `googlebusiness`) |
| `account_name`       | String  | Display name of the account                                              |
| `account_username`   | String  | Username/handle on the platform                                          |
| `account_avatar`     | String  | Avatar image URL                                                         |
| `connected_at`       | String  | ISO timestamp when the account was connected                             |
| `requires_reconnect` | Boolean | Whether the account needs reconnection (only with `include_health=true`) |

## Rate Limits

This endpoint is rate limited to **20 requests per minute** per workspace. Rate limit headers are included in every response:

| Header                  | Description              |
| ----------------------- | ------------------------ |
| `X-RateLimit-Limit`     | Maximum requests per minute |
| `X-RateLimit-Remaining` | Remaining requests in the current window |
| `Retry-After`           | Seconds to wait (only on `429` responses) |

## Error Responses

| Code | Description                            |
| ---- | -------------------------------------- |
| 403  | Missing or invalid API key             |
| 429  | Rate limit exceeded                    |