> This page is for API Reference.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

# List all Channels

GET https://api.contentful.com/organizations/{organizationId}/channels

Returns every Channel in the organization.

Reference: https://contentful.com/developers/docs/references/experience-management-api/destinations-management/destinations/channels/list-channels

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `organizationId` (string, required) — ID of the organization the Channel belongs to.

## Response

### 200

OK - Request successful

- `sys` (ChannelCollectionSys, required)
- `limit` (integer, required)
- `items` (list of Channel, required)
- `pages` (Pages, required) — Cursor tokens for paging through a collection. Treat the values as opaque.

## Types

### ChannelCollectionSys

- `type` ("Array", optional)

### Channel

- `name` (string, required)
- `description` (string, required)
- `properties` (list of ChannelPropertyDefinition, required)
- `nodeProperties` (list of ChannelNodePropertyDefinition, required)
- `sys` (ChannelSys, required)

### Pages

Cursor tokens for paging through a collection. Treat the values as opaque.

- `next` (string, optional) — Cursor for the next page. Present only when more resources are available.
- `prev` (string, optional) — Cursor for the previous page.

### ChannelPropertyDefinition

Declares a property that every Destination linked to this Channel must supply.

- `name` (string, required) — Human-readable name of the property.
- `id` (string, required) — Identifier a Destination uses to supply a value for this property. Must be unique within the Channel.
- `type` (enum, required) — Value type accepted for this property.
  - Allowed values: `String`, `Boolean`, `Number`

### ChannelNodePropertyDefinition

Declares a property carried by the Destination Nodes of every Destination linked to this Channel.

- `name` (string, required) — Human-readable name of the Destination Node property. Must be unique within the Channel.
- `type` (string, required) — Value type accepted for this Destination Node property. `Path` marks the Destination Node property that supplies routing paths, and a Channel can declare at most one of them.

### ChannelSys

- `createdAt` (string, optional) — Date and time the resource was created.
- `createdBy` (Link, optional) — Link to another Contentful resource.
- `firstPublishedAt` (string, optional) — Date and time the resource was published for the first time.
- `id` (string, optional)
- `organization` (Link, optional) — Link to another Contentful resource.
- `publishedAt` (string, optional) — Date and time the resource was last published.
- `publishedBy` (Link, optional) — Link to another Contentful resource.
- `publishedCounter` (integer, optional) — Number of times the resource has been published.
- `publishedVersion` (integer, optional) — Version of the resource that is currently published.
- `type` ("Channel", optional)
- `updatedAt` (string, optional) — Date and time the resource was last updated.
- `updatedBy` (Link, optional) — Link to another Contentful resource.
- `version` (integer, optional) — Current version of the resource. Send this value as `X-Contentful-Version` when updating, deleting, publishing, or unpublishing.

### Link

Link to another Contentful resource.

- `sys` (LinkSys, required)

### LinkSys

- `type` ("Link", required)
- `linkType` (string, required)
- `id` (string, required)

## Examples

**Response**

```json
{
  "sys": {
    "type": "Array"
  },
  "limit": 1,
  "items": [
    {
      "name": "name",
      "description": "description",
      "properties": [
        {
          "name": "Base URL",
          "id": "baseUrl",
          "type": "String"
        }
      ],
      "nodeProperties": [
        {
          "name": "Path",
          "type": "Path"
        }
      ],
      "sys": {}
    }
  ],
  "pages": {
    "next": "next",
    "prev": "prev"
  }
}
```