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

# List all connected channels

`GET /channels`

## Request

- Base URL: `https://www.app.ocoya.com/api/_public/v1`
- URL: `https://www.app.ocoya.com/api/_public/v1/channels`
- Auth: API key in header `X-API-Key`

Returns every channel connected to the brand: the accounts, pages and databases Ocoya posts to.

## Query parameters

- `brandId` string, required

## Response `200`

Success

- object[]
  - `id` string, required: Channel ID. Pass it in `channelIds` when creating or updating posts.
  - `provider` string, required: Network the channel is on.
  - `name` string, nullable, required: Channel name as shown on the network.
  - `profileBoards` object[], required: Boards the channel can post to, for networks that have them (Pinterest). Empty for the rest.

## Other responses

- `401`: Missing or invalid API key.
- `403`: Invalid brand id, or the API key's user does not own this brand.
- `429`: Rate limit exceeded: 60 requests per minute per API key.
- `500`: Unknown error

## Changes

- **2026-11-04** `ef9bd3530850`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ocoya/apis/ocoya-api/changes/channels/get.md)

---

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