...
The client can obtain a list of recording groups available to their profile by calling the recording groups endpoint. Recordings are grouped by series by default, but the grouping can be defined with the group_by parameter. The group_by parameter accepts series_id, channel_id or both combined. When both series_id and channel_id are combined, the endpoint will return one group per unique series_id-channel_id combination. Filters are available for favourite, starts_before, starts_after, ends_before, ends_after. The filters does not filter the groups themselves, but the recordings contained in the groups, i.e. the groups are returned as if the filtered recordings do not exist. Recordings that do not fit into any group are not included in the response.
The contents of each group can be obtained from the search recordings endpoint using appropriate filters.
...