Types

The full object and enum reference. Introspection is open, so the live schema at the endpoint is always authoritative - this page explains the intent behind each field.

Property

The root object, returned by the property query.

Field	Type	Notes
id	ID!
name	String!
brands(limit, offset)	BrandList!	Curated brands (excludes deleted). Paginated
streams(limit, offset)	StreamList!	Curated live streams. OFFLINE streams stay listed. Paginated

Brand

Field	Type	Notes
id	ID!
title	String!
code	String!	Stable short code for the brand
coverUrl	String	Cover image URL, may be null - see Playback & images
seasons(limit, offset)	SeasonList!	Ordered by orderInGroup. Paginated

Season

Field	Type	Notes
id	ID!
title	String!
coverUrl	String	May be null - see Playback & images
episodes(limit, offset)	EpisodeList!	Ordered by orderInSeason. Paginated

Episode

Field	Type	Notes
id	ID!
title	String!
status	EpisodeStatus!	READY or PROCESSING
playbackUrl	String!	Always present; check status before playing - see Playback & images
coverUrl	String	May be null - see Playback & images

Stream

Field	Type	Notes
id	ID!
title	String!
status	StreamStatus!	LIVE or OFFLINE
playbackUrl	String!	Always present, even when OFFLINE; check status before playing - see Playback & images
coverUrl	String	May be null - see Playback & images

Enums

enum EpisodeStatus {
  READY        # a playable HLS rendition exists
  PROCESSING   # transcoding not finished yet
}

enum StreamStatus {
  LIVE         # source is ONLINE
  OFFLINE      # everything else
}

Tolerate unknown enum values

New enum members may be added in future phases. Treat any value you do not recognize as a safe default (e.g. "not playable") rather than crashing. See Versioning.

List wrappers

Every paginated field returns a *List wrapper - BrandList, SeasonList, EpisodeList, StreamList - with the same shape:

Field	Type	Notes
items	[T!]!	The page of results
total	Int!	Count of all matching rows, ignoring limit/offset. Computed only when selected