HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Want to write your own code to work with a HDHomeRun or work with the HDHomeRun DVR? We are happy to help with concepts, APIs, best practices.
Post Reply
JPTapt
Posts: 1
Joined: Tue Jul 21, 2026 5:34 am

HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Post by JPTapt »

I am trying to understand how the DVR determines the exact airing instance that will be recorded.

For a series recording rule, the guide data can contain multiple airings of the same episode. For example:

Grantchester on Masterpiece
S11E08

- Aug 2 9:00 PM - Channel 30.1
- Aug 3 5:00 PM - Channel 30.1
- Aug 3 2:00 AM - Channel 30.1

The HDHomeRun app shows a red recording indicator next to the specific airings that are scheduled to record. I would like to retrieve that same information through an API.

I can retrieve:
- Series information from recorded_files.json
- Episode listings from:
https://api.hdhomerun.com/api/episodes? ... &SeriesID=...
- Upcoming recordings from:
https://api.hdhomerun.com/api/upcoming_ ... eviceAuth=...

However, I have not found an API response that identifies the actual selected airing instance (ProgramID + StartTime + ChannelNumber) that the DVR has scheduled.

The episode API returns fields like:
- ProgramID
- StartTime
- RecordingRule
- RecordingRuleExt (RecordIfNotRecorded / RecordDuplicate)

but those appear to indicate that the episode matches a rule, not which specific airing will be recorded.

Is there a DVR endpoint or API call that exposes the scheduled recording instances before they occur?

Ideally I am looking for something equivalent to:

{
"ProgramID": "EP025199990078",
"ChannelNumber": "30.1",
"StartTime": 1785718800,
"Status": "Scheduled"
}

The goal is to display the same information as the HDHomeRun app: show the actual scheduled airing, and when selected, show the other possible airings with the scheduled one marked.

Thanks

Post Reply