> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mallary.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Connected Platforms

> List Mallary-supported platforms and see which ones are connected for the authenticated account.

Use `profile_id` to read a non-default connection profile. The response also includes the profile list, default profile id, and the workspace's current account limits.

Each platform row includes `post_types` and `post_type_selection`. For example, Facebook and Instagram include `story`. An empty `post_types` list with `post_type_selection: "automatic"` means Mallary chooses the format from the content and media.


## OpenAPI

````yaml GET /api/v1/platforms
openapi: 3.0.3
info:
  title: Mallary API
  version: 1.6.0
  description: >
    Public API for multi-platform publishing, analytics, media upload, and
    webhooks.


    Authentication:

    - Use header `Authorization: Bearer {api_key}`.

    - API key identity is authoritative. Do not use `user_id` to identify a
    caller.


    Connection profiles:

    - Omit `profile_id` to use the authenticated user's default profile.

    - Send the profile's random public `profile_id` when you want to publish,
    list posts, read post analytics or audience counts, list platforms, update
    settings, or disconnect a platform for a non-default profile.

    - Use `GET /api/v1/profiles` to list profile IDs.

    - Total social media accounts: Starter 5 ($15/month), Pro 15 ($29/month),
    Business 100 ($95/month). Posts are unlimited. Scheduling, analytics, and AI
    auto-replies are included. X publishing and comments use credits at cost;
    analytics and account lookups use no credits. Existing customers keep their
    current terms; use the authenticated workspace limits.


    Rate limits (per user, per minute) depend on subscription plan:

    - plan_id 1: 75 req/min

    - plan_id 2: 150 req/min

    - plan_id 3: 750 req/min

    - plan_id 4: 1500 req/min
servers:
  - url: https://mallary.ai
    description: Production
security:
  - bearerAuth: []
externalDocs:
  description: Full product docs
  url: https://docs.mallary.ai/
paths:
  /api/v1/platforms:
    get:
      summary: List connected platforms
      description: >-
        Returns Mallary's supported public platform set, marks which platforms
        are currently connected for the selected connection profile, and lists
        exact selectable post types where the API supports an explicit type.
      operationId: listPlatforms
      parameters:
        - in: query
          name: profile_id
          required: false
          schema:
            $ref: '#/components/schemas/ProfileId'
          description: Connection profile to inspect. Omit to use the default profile.
      responses:
        '200':
          description: Platform connection summary retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectedPlatformsResponse'
        '401':
          description: Missing or invalid API key
        '403':
          description: Supplied `user_id` (if any) does not match API key owner
components:
  schemas:
    ProfileId:
      type: string
      pattern: ^[A-Za-z0-9]{6,32}$
      example: AbC123xYz90
      description: Random public connection profile ID returned by `GET /api/v1/profiles`.
    ConnectedPlatformsResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - ok
        data:
          type: object
          properties:
            platforms:
              type: array
              items:
                $ref: '#/components/schemas/ConnectedPlatformItem'
            profile_id:
              type: string
              pattern: ^[A-Za-z0-9]{6,32}$
              nullable: true
            default_profile_id:
              type: string
              pattern: ^[A-Za-z0-9]{6,32}$
              nullable: true
            profiles:
              type: array
              items:
                $ref: '#/components/schemas/ConnectionProfile'
            connected:
              type: array
              items:
                $ref: '#/components/schemas/PublicPlatform'
            disconnected:
              type: array
              items:
                $ref: '#/components/schemas/PublicPlatform'
            counts:
              $ref: '#/components/schemas/ConnectedPlatformsCounts'
            limits:
              $ref: '#/components/schemas/ProfileLimits'
    ConnectedPlatformItem:
      type: object
      properties:
        platform:
          $ref: '#/components/schemas/PublicPlatform'
        connected:
          type: boolean
        post_types:
          type: array
          description: >-
            Exact values accepted as `platform_options.<platform>.post_type`.
            Empty when Mallary selects the format from the content and media.
          items:
            type: string
        post_type_selection:
          type: string
          enum:
            - explicit
            - automatic
          description: >-
            Whether callers may select a listed post type or Mallary determines
            the format from content and media.
    ConnectionProfile:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/ProfileId'
        name:
          type: string
        is_default:
          type: boolean
        connected_platforms:
          type: array
          items:
            $ref: '#/components/schemas/PublicPlatform'
        platform_profiles:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/PlatformProfile'
        created_at:
          type: string
          nullable: true
        updated_at:
          type: string
          nullable: true
    PublicPlatform:
      type: string
      description: >-
        Canonical public platform identifier used in connected-platform
        listings.
      enum:
        - x
        - facebook
        - instagram
        - linkedin
        - youtube
        - tiktok
        - pinterest
        - reddit
        - threads
        - bluesky
    ConnectedPlatformsCounts:
      type: object
      properties:
        connected:
          type: integer
        supported:
          type: integer
    ProfileLimits:
      type: object
      properties:
        max_accounts_per_platform:
          type: integer
          description: >-
            Compatibility field for per-platform limits. Use max_accounts_total
            when account_limit_scope is total.
        max_accounts_total:
          type: integer
          nullable: true
          description: >-
            Total connected social accounts allowed across platforms and
            profiles. Null for a platform-based contract.
        account_limit_scope:
          type: string
          enum:
            - total
            - platform
          description: >-
            Whether the account allowance is pooled or counted separately per
            platform.
    PlatformProfile:
      type: object
      properties:
        id:
          type: string
          nullable: true
        username:
          type: string
          nullable: true
        avatar:
          type: string
          nullable: true
        scope:
          type: string
          nullable: true
        updated_at:
          type: string
          nullable: true
        expires_at:
          type: string
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use `Authorization: Bearer {api_key}`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.