> ## Documentation Index
> Fetch the complete documentation index at: https://uafilms.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Серії сезону

> Повертає список серій, назви, описи та дати виходу для конкретного сезону серіалу.



## OpenAPI

````yaml GET /api/season
openapi: 3.0.3
info:
  title: UAFilms API
  description: >-
    API агрегатора українського медіа-контенту та OMSS (Open Media Streaming
    Specification) стрімінговий сервер з підтримкою HLS проксі, динамічного
    Server-Sent Events (SSE) парсингу, системи акаунтів та персональних
    API-ключів.
  version: 1.2.0
servers:
  - url: https://films.aartzz.pp.ua
    description: Production Server
  - url: http://localhost:3000
    description: Local Development Server
security: []
paths:
  /api/season:
    get:
      summary: Епізоди сезону серіалу
      description: >-
        Повертає список серій, назви, описи та дати виходу для конкретного
        сезону серіалу.
      parameters:
        - name: id
          in: query
          description: TMDB ID серіалу
          required: true
          schema:
            type: string
            example: '284445'
        - name: season
          in: query
          description: Номер сезону
          required: false
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Деталі сезону та серій
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SeasonDetails'
components:
  schemas:
    SeasonDetails:
      type: object
      properties:
        seasonNumber:
          type: integer
          example: 1
        title:
          type: string
          example: Сезон 1
        episodes:
          type: array
          items:
            $ref: '#/components/schemas/EpisodeDetails'
    EpisodeDetails:
      type: object
      properties:
        episodeNumber:
          type: integer
          example: 1
        seasonNumber:
          type: integer
          example: 1
        title:
          type: string
          example: Пілотна серія
        overview:
          type: string
          example: Початок історії...
        stillUrl:
          type: string
          nullable: true
          example: https://image.tmdb.org/t/p/w300/xyz.jpg
        airDate:
          type: string
          example: '2026-01-15'

````