---
title: "List connected accounts"
method: GET
path: "/connections"
tags: ["Connections"]
---

# List connected accounts

`GET /connections`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/connections`
- Auth: API key in header `Authorization`

Active connected social accounts for the caller.

## Response `200`

Connected accounts.

- ConnectionsResponse
  - `accounts` ConnectedAccount[], required
    - `id` string, uuid
    - `platform` string
    - `display_name` string, nullable
    - `avatar_url` string, nullable
    - `status` 'active'

## Other responses

- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: Plan limit: no active plan (any write; `reason: "no_active_plan"`), a monthly allowance is spent, or the feature is not on the caller's plan. Detect by `code: "plan_limit_exceeded"`.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).

---

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