---
title: "List accounts"
method: GET
path: "/v1/accounts"
---

# List accounts

`GET /v1/accounts`

## Request

- Base URL: `https://postonce.to/api/public`
- URL: `https://postonce.to/api/public/v1/accounts`
- Auth: HTTP bearer

Returns all social accounts owned by the API key profile, including disconnected accounts.

## Response `200`

Accounts returned successfully.

- object
  - `data` Account[]
    - `id` string
    - `platform` 'bluesky' | 'facebook' | 'farcaster' | 'nostr' | 'telegram' | 'instagram' | 'linkedin' | 'pinterest' | 'reddit' | 'snapchat' | 'threads' | 'tiktok' | 'twitter' | 'vimeo' | 'youtube'
    - `username` string
    - `avatar_url` string, nullable
    - `status` 'active' | 'auth_required' | 'disconnected'
    - `capabilities` object, nullable: Discoverable account capabilities used by both the public API and generated MCP tools.
      - `connection_mode` string
      - `destination` boolean
      - `source` boolean
      - `backfill` boolean
      - `text` boolean
      - `images` boolean
      - `video` boolean
      - `replies` boolean
      - `threads` boolean
    - `media_requirements` object, nullable: Media input constraints from PostOnce's publishing validator. Check required_media before a text-only post. Platform-level guidance is not proof of current account authorization or delivery success. Format conversions remain subject to processing limits.
      - `supported_formats` string[]
      - `convertible_formats` object
      - `max_size_bytes` object
        - `image` integer
        - `video` integer
        - `gif` integer
      - `file_constraints` object: maxFiles, maxVideoFiles, maxImageFiles, optional maxGifFiles, allowMixedMedia and optional gifBehavior.
      - `required_media` object, nullable: When present: minFiles and acceptedTypes (image/video) define mandatory media, with errorCode and errorMessage.
      - `max_hashtags` integer, nullable
      - `min_video_duration_seconds` number, nullable
      - `max_video_duration_seconds` number, nullable
      - `aspect_ratio` object, nullable
      - `thumbnail` object, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing, invalid, revoked, or expired API key.

---

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