---
title: "List channels"
method: GET
path: "/channels"
tags: ["channels"]
---

# List channels

`GET /channels`

## Request

- Base URL: `https://www.socialfaktory.com/v1`
- URL: `https://www.socialfaktory.com/v1/channels`
- Auth: HTTP bearer

List a brand connected social channels with the caption and media limits each one enforces.

## Query parameters

- `brand_id` string: The brand this call belongs to. Required unless the token is pinned to a brand.

## Response `200`

List channels

- object
  - `channels` object[], required
    - `id` string, required
    - `provider` string, required
    - `handle` string, nullable
    - `status` string, required
    - `caption_limit` integer, nullable
    - `media_required` boolean
    - `max_media` integer, nullable

## Other responses

- `default`: The error envelope

---

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