---
title: "Gets episodes matching the given criteria."
method: GET
path: "/api/v2/episodes"
tags: ["Episodes"]
---

# Gets episodes matching the given criteria.

`GET /api/v2/episodes`

## Query parameters

- `id` integer
- `beginAirDateAfter` string, date-time
- `endAirDateBefore` string, date-time
- `programId` integer, required
- `pageStart` integer
- `pageSize` integer
- `orderById` 'asc' | 'desc'

## Response `200`

The matching episode.

- Episode[]
  - `id` integer — The unique ID of the episode. Generated at creation.
  - `programId` integer, required — The ID of the program that owns this episode.
  - `customerId` integer — The ID of the customer that owns this programs.
  - `title` string, required — The title of the program.
  - `createdDate` string, date-time — The date the segment was created in ISO 8601 format. Generated at creation.
  - `lastModifiedDate` string, date-time — The date the segment was last modified/updated in ISO 8601 format. Automatically updated on any write operation.
  - `beginAirDate` string, date-time, required — The date the air window opens for the episode in ISO 8601 format.
  - `endAirDate` string, date-time, required — The date the air window closes for the episode in ISO 8601 format.
  - `beginTransmissionDate` string, date-time — The date the live stream begins for the episode in ISO 8601 format. Only set for live and LWSF episodes.
  - `endTransmissionDate` string, date-time — The date the live stream ends for the episode in ISO 8601 format. Only set for live and LWSF episodes.

## Other responses

- `400` — The request is missing required data or invalid.
- `403` — Authorization failed, or the user is not permitted to view this program or its episodes.
- `404` — The program cannot be found.

---

[API](https://skmtc.dev/prss/apis/contentdepot.md) · [All operations](https://skmtc.dev/prss/apis/contentdepot/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prss/contentdepot/revisions/838e7ae589d8/schema)