---
title: "Channel Collection"
method: GET
path: "/channel"
tags: ["Channel"]
---

# Channel Collection

`GET /channel`

If you are interested in a list of channels that have had there schedule updated you can filter by the following query params.
 - scheduleStart
 - scheduleEnd
 - scheduleUpdatedSince

adding these query params will filter the channel collection to only return channels that have been updated within the given range, updatedSince stores the state of your previous call.

Example Usage: Every 10 minutes get me the channels that have updated schedules for the next 2 weeks.

/channel?platform={uuid}&scheduleStart={today}&scheduleEnd={today + 2 weeks}&updatedSince={10 minutes ago}

Also please note epg numbers are only exposed when a platform and region are passed to the query.

## Query parameters

- `platformId` string
- `regionId` string
- `aliases` boolean
- `date` string
- `scheduleStart` string
- `scheduleEnd` string
- `scheduleUpdatedSince` string

## Response `200`

OK

- object

## Changes

> 50 revisions in range; 2 could not be searched.

- **2019-02-20** `dce5e78f60ee` — 1 warning, 1 info
  - deleted the `query` request parameter `start`
  - added the new optional `query` request parameter `date`
- **2018-10-22** `c18d629d4393` — 1 warning, 1 info
  - deleted the `query` request parameter `scheudleEnd`
  - added the new optional `query` request parameter `scheduleEnd`
- **2018-10-22** `b02d152d2dd2` — 2 info
  - the `query` request parameter `platformId` became optional
  - the `query` request parameter `regionId` became optional
- **2018-10-22** `87ec4812092c` — 2 breaking
  - the `query` request parameter `platformId` became required
  - the `query` request parameter `regionId` became required
- **2018-10-18** `f9dcf79e2dcc` — 2 info
  - the `query` request parameter `platformId` became optional
  - the `query` request parameter `regionId` became optional

[Full history](https://skmtc.dev/pressassociation/apis/tv-api/changes/channel/get.md)

---

[API](https://skmtc.dev/pressassociation/apis/tv-api.md) · [All operations](https://skmtc.dev/pressassociation/apis/tv-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pressassociation/tv-api/revisions/dac83d4648c2/schema)