...

Recordings can be searched using the search recordings endpoint. If no search string is provided, then all recordings for the profile are returned. Note that the response is paginated. The recording search endpoint accepts a number of filters to limit the objects returned. The series.id filter accepts a special value "null" which matches only recordings for programs with no series (e.g. movies).

Recording groups

For an improved user experience, a grouping API is provided to allow clients to display groups of recordings to the user without having to fetch all recording data at once.

...