SECTION 7 — EPG / SCHEDULE

38. GET /creators/:id/channel/schedule

Get the full EPG schedule for the creator's channel.

Query Parameters

Parameter	Type	Required	Default	Description
date	string	No	Today	YYYY-MM-DD
timezone	string	No	UTC	e.g. America/New_York
from	string	No	—	Start time HH:MM 24hr
to	string	No	—	End time HH:MM 24hr

Request

GET /creators/creator_001/channel/schedule?date=2024-11-01&timezone=America/New_York&from=17:00&to=21:30

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "channel_name": "Chris Spencer 24/7",
    "channel_number": 101,
    "date": "2024-11-01",
    "timezone": "America/New_York",
    "timeline": {
      "start": "5:00 PM",
      "end": "9:30 PM",
      "slot_interval_minutes": 30,
      "slots": ["5:00 PM", "5:30 PM", "6:00 PM", "6:30 PM", "7:00 PM", "7:30 PM", "8:00 PM", "8:30 PM", "9:00 PM", "9:30 PM"]
    },
    "schedule": [
      {
        "program_id": "prog_001",
        "title": "Go Big or Go Home",
        "thumbnail_url": "https://cdn.droptv.com/programs/prog_001/thumb.jpg",
        "start_time": "2024-11-01T17:30:00-05:00",
        "end_time": "2024-11-01T18:00:00-05:00",
        "start_time_formatted": "5:30 PM",
        "end_time_formatted": "6:00 PM",
        "duration_minutes": 30,
        "is_past": true,
        "is_current": false,
        "is_upcoming": false,
        "content_type": "show",
        "content_id": "show_008",
        "rating": "TV-PG"
      },
      {
        "program_id": "prog_002",
        "title": "Behind the Laughs",
        "thumbnail_url": "https://cdn.droptv.com/programs/prog_002/thumb.jpg",
        "start_time": "2024-11-01T18:00:00-05:00",
        "end_time": "2024-11-01T18:45:00-05:00",
        "start_time_formatted": "6:00 PM",
        "end_time_formatted": "6:45 PM",
        "duration_minutes": 45,
        "elapsed_minutes": 15,
        "remaining_minutes": 30,
        "progress_percent": 33,
        "is_past": false,
        "is_current": true,
        "is_upcoming": false,
        "content_type": "episode",
        "content_id": "ep_005",
        "rating": "TV-14"
      }
    ]
  }
}

39. GET /creators/:id/channel/schedule/current

Get the currently airing program.

Query Parameters

Parameter	Type	Required	Default	Description
timezone	string	No	UTC	e.g. America/New_York

Request

GET /creators/creator_001/channel/schedule/current?timezone=America/New_York

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "channel_name": "Chris Spencer 24/7",
    "is_live": true,
    "watching_now": 13000,
    "watching_now_formatted": "13K",
    "current_program": {
      "program_id": "prog_002",
      "title": "Behind the Laughs",
      "thumbnail_url": "https://cdn.droptv.com/programs/prog_002/thumb.jpg",
      "start_time_formatted": "6:00 PM",
      "end_time_formatted": "6:45 PM",
      "duration_minutes": 45,
      "elapsed_minutes": 15,
      "remaining_minutes": 30,
      "progress_percent": 33,
      "content_type": "episode",
      "content_id": "ep_005",
      "rating": "TV-14"
    },
    "next_program": {
      "program_id": "prog_003",
      "title": "Chris Spencer Presents",
      "start_time_formatted": "7:00 PM",
      "duration_minutes": 60,
      "starts_in_minutes": 30
    }
  }
}

40. GET /creators/:id/channel/schedule/upcoming

Get upcoming programs on the channel.

Query Parameters

Parameter	Type	Required	Default	Description
timezone	string	No	UTC	e.g. America/New_York
limit	int	No	5	Number of programs to return

Request

GET /creators/creator_001/channel/schedule/upcoming?timezone=America/New_York&limit=5

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "channel_name": "Chris Spencer 24/7",
    "upcoming_programs": [
      {
        "program_id": "prog_003",
        "title": "Chris Spencer Presents",
        "thumbnail_url": "https://cdn.droptv.com/programs/prog_003/thumb.jpg",
        "start_time_formatted": "7:00 PM",
        "end_time_formatted": "8:00 PM",
        "duration_minutes": 60,
        "starts_in_minutes": 30,
        "is_upcoming": true,
        "content_type": "show",
        "content_id": "show_001",
        "rating": "TV-14"
      }
    ]
  }
}

41. GET /creators/:id/channel/live/epg

Get complete EPG for the current live session.

Query Parameters

Parameter	Type	Required	Default	Description
date	string	No	Today	YYYY-MM-DD
timezone	string	No	UTC	e.g. America/New_York
from	string	No	—	Start time HH:MM
to	string	No	—	End time HH:MM

Request

GET /creators/creator_001/channel/live/epg?date=2024-11-01&timezone=America/New_York

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "date": "2024-11-01",
    "timezone": "America/New_York",
    "timeline": {
      "start": "5:00 PM",
      "end": "9:30 PM",
      "slot_interval_minutes": 30,
      "slots": ["5:00 PM", "5:30 PM", "6:00 PM", "6:30 PM", "7:00 PM", "7:30 PM", "8:00 PM", "8:30 PM", "9:00 PM", "9:30 PM"]
    },
    "schedule": [
      {
        "program_id": "prog_002",
        "title": "Behind the Laughs",
        "start_time_formatted": "6:00 PM",
        "end_time_formatted": "6:45 PM",
        "duration_minutes": 45,
        "progress_percent": 33,
        "is_current": true,
        "rating": "TV-14"
      }
    ]
  }
}

42. GET /creators/:id/channel/live/epg/current

Get the currently airing program with live progress.

Query Parameters

Parameter	Type	Required	Default	Description
timezone	string	No	UTC	e.g. America/New_York

Request

GET /creators/creator_001/channel/live/epg/current?timezone=America/New_York

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "is_live": true,
    "watching_now": 13245,
    "watching_now_formatted": "13.2K",
    "current_program": {
      "program_id": "prog_002",
      "title": "Behind the Laughs",
      "description": "A behind-the-scenes look at Chris Spencer's comedy world.",
      "thumbnail_url": "https://cdn.droptv.com/programs/prog_002/thumb.jpg",
      "start_time_formatted": "6:00 PM",
      "end_time_formatted": "6:45 PM",
      "duration_minutes": 45,
      "elapsed_minutes": 15,
      "remaining_minutes": 30,
      "progress_percent": 33,
      "content_type": "episode",
      "content_id": "ep_005",
      "rating": "TV-14"
    },
    "next_program": {
      "program_id": "prog_003",
      "title": "Chris Spencer Presents",
      "start_time_formatted": "7:00 PM",
      "starts_in_minutes": 30,
      "duration_minutes": 60
    }
  }
}

43. GET /creators/:id/channel/live/epg/next

Get next upcoming programs on the live channel.

Query Parameters

Parameter	Type	Required	Default	Description
timezone	string	No	UTC	e.g. America/New_York
limit	int	No	3	Number of programs

Request

GET /creators/creator_001/channel/live/epg/next?timezone=America/New_York&limit=3

Response 200 OK

{
  "status": "success",
  "data": {
    "channel_id": "ch_101",
    "upcoming_programs": [
      {
        "program_id": "prog_003",
        "title": "Chris Spencer Presents",
        "thumbnail_url": "https://cdn.droptv.com/programs/prog_003/thumb.jpg",
        "start_time_formatted": "7:00 PM",
        "end_time_formatted": "8:00 PM",
        "duration_minutes": 60,
        "starts_in_minutes": 30,
        "content_type": "show",
        "content_id": "show_001",
        "rating": "TV-14"
      }
    ]
  }
}