# ChannelsList

> List channels (UTM sources) with type, social network, status and UTM values. Read access, channels toolset, MCP tool list_channels.

**Access:** [Read](https://developer.missin.co.uk/get-started/authentication.md#access-levels)

## Variables

| Variable | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `after` | `Cursor` | no | Opaque cursor from `pageInfo.endCursor` |  |
| `filter` | `ChannelFilter` | no | Input object, below |  |
| `first` | `Int!` | yes | 32-bit integer. MCP tools send `50` when it is left out |  |

## Input types

A filter lists its fields by the type they take, and none of them is required.

### ChannelFilter

- `[ChannelFilter!]`: `and`, `or`
- [StringFilter](https://developer.missin.co.uk/reference/input-types.md#stringfilter): `channelSlug`, `name`, `utmContent`, `utmMedium`, `utmSource`
- [UUIDFilter](https://developer.missin.co.uk/reference/input-types.md#uuidfilter): `channelTypeId`, `rowId`, `socialNetworkId`
- `ChannelFilter`: `not`
- `Boolean`: `socialNetworkBySocialNetworkIdExists`
- `ChannelStatusFilter`: `status`

### ChannelStatusFilter

- `ChannelStatus` (One of `ACTIVE`, `DISABLED`, `DROPPED`): `equalTo`, `greaterThan`, `greaterThanOrEqualTo`, `lessThan`, `lessThanOrEqualTo`, `notEqualTo`
- `[ChannelStatus!]` (One of `ACTIVE`, `DISABLED`, `DROPPED`): `in`, `notIn`
- `Boolean`: `isNull`

## Call it

```bash curl
curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"ChannelsList","variables":{"first":50},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"c9c0b0d141145fc54f269a90cc3e966ff448d783a0e6655dcf0f3472537fe792"}}}'
```

## Document

```graphql
query ChannelsList($after: Cursor, $filter: ChannelFilter, $first: Int!) { __typename allChannels(first: $first, after: $after, orderBy: [NAME_ASC], filter: $filter) { __typename nodes { __typename channelSlug channelTypeByChannelTypeId { __typename displayName id name rowId slug } createdAt displayName id mediaKind name rowId socialNetworkBySocialNetworkId { __typename id name rowId slug } status utmContent utmMedium utmSource } pageInfo { __typename endCursor hasNextPage } totalCount } }
```

Source: https://developer.missin.co.uk/reference/channels/channels-list