---
title: "Entity (core)"
slug: "170-core-entity-schemas"
updated: 2025-12-09T17:41:05Z
published: 2025-12-09T18:02:06Z
canonical: "docs.developer.comcast.com/170-core-entity-schemas"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.developer.comcast.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entity (core)

**Entity Schema 1.7.0 | Core SDK**

## Types

### MovieEntity

A Firebolt compliant representation of a Movie entity.

```
type MovieEntity = {
  entityType: 'program'
  programType: 'movie'
  entityId: string
  assetId?: string
  appContentData?: string
}
```

---

### Metadata

```
type Metadata = {
  title?: string // Title of the entity.
  synopsis?: string // Short description of the entity.
  seasonNumber?: number // For TV seasons, the season number. For TV episodes, the season that the episode belongs to.
  seasonCount?: number // For TV series, seasons, and episodes, the total number of seasons.
  episodeNumber?: number // For TV episodes, the episode number.
  episodeCount?: number // For TV seasons and episodes, the total number of episodes in the current season.
  releaseDate?: string // The date that the program or entity was released or first aired.
  contentRatings?: ContentRating[] // A ContentRating represents an age or content based of an entity. Supported rating schemes and associated types are below.
}
```

See also:

[ContentRating](/docs/170-core-Entertainment-schemas#ContentRating)

---

### MusicEntity

```
type MusicEntity = {
  entityType: 'music'
  musicType: MusicType // In the case of a music `entityType`, specifies the type of music entity.
  entityId: string
}
```

See also:

[MusicType](/docs/170-core-Entertainment-schemas#MusicType)

---

### ChannelEntity

```
type ChannelEntity = {
  entityType: 'channel'
  channelType: 'streaming' | 'overTheAir'
  entityId: string // ID of the channel, in the target App's scope.
  appContentData?: string
}
```

---

### UntypedEntity

```
type UntypedEntity = {
  entityId: string
  assetId?: string
  appContentData?: string
}
```

---

### PlaylistEntity

A Firebolt compliant representation of a Playlist entity.

```
type PlaylistEntity = {
  entityType: 'playlist'
  entityId: string
  assetId?: string
  appContentData?: string
}
```

---

### TVEpisodeEntity

A Firebolt compliant representation of a TV Episode entity.

```
type TVEpisodeEntity = {
  entityType: 'program'
  programType: 'episode'
  entityId: string
  seriesId: string
  seasonId: string
  assetId?: string
  appContentData?: string
}
```

---

### TVSeasonEntity

A Firebolt compliant representation of a TV Season entity.

```
type TVSeasonEntity = {
  entityType: 'program'
  programType: 'season'
  entityId: string
  seriesId: string
  assetId?: string
  appContentData?: string
}
```

---

### TVSeriesEntity

A Firebolt compliant representation of a TV Series entity.

```
type TVSeriesEntity = {
  entityType: 'program'
  programType: 'series'
  entityId: string
  assetId?: string
  appContentData?: string
}
```

---

### AdditionalEntity

A Firebolt compliant representation of the remaining program entity types.

```
type AdditionalEntity = {
  entityType: 'program'
  programType:
    | 'concert'
    | 'sportingEvent'
    | 'preview'
    | 'other'
    | 'advertisement'
    | 'musicVideo'
    | 'minisode'
    | 'extra'
  entityId: string
  assetId?: string
  appContentData?: string
}
```

---

### ProgramEntity

```
type ProgramEntity =
  | MovieEntity
  | TVEpisodeEntity
  | TVSeasonEntity
  | TVSeriesEntity
  | AdditionalEntity
```

See also:

[MovieEntity](/docs/170-core-entity-schemas#movieentity) [TVEpisodeEntity](/docs/170-core-entity-schemas#tvepisodeentity) [TVSeasonEntity](/docs/170-core-entity-schemas#tvseasonentity) [TVSeriesEntity](/docs/170-core-entity-schemas#tvseriesentity) [AdditionalEntity](/docs/170-core-entity-schemas#additionalentity)

---

### Entity

```
type Entity =
  | ProgramEntity
  | MusicEntity
  | ChannelEntity
  | UntypedEntity
  | PlaylistEntity
```

See also:

[ProgramEntity](/docs/170-core-entity-schemas#programentity) [MusicEntity](/docs/170-core-entity-schemas#musicentity) [ChannelEntity](/docs/170-core-entity-schemas#channelentity) [UntypedEntity](/docs/170-core-entity-schemas#untypedentity) [PlaylistEntity](/docs/170-core-entity-schemas#playlistentity)

---

### EntityDetails

```
type EntityDetails = {
  identifiers:
    | ProgramEntity
    | MusicEntity
    | ChannelEntity
    | UntypedEntity
    | PlaylistEntity
  info?: Metadata
  waysToWatch?: WayToWatch[] // A WayToWatch describes a way to watch a video program. It may describe a single
}
```

See also:

[Metadata](/docs/170-core-entity-schemas#metadata) [WayToWatch](/docs/170-core-Entertainment-schemas#WayToWatch)

---

### PlayableEntity

```
type PlayableEntity =
  | MovieEntity
  | TVEpisodeEntity
  | PlaylistEntity
  | MusicEntity
  | AdditionalEntity
```

See also:

[MovieEntity](/docs/170-core-entity-schemas#movieentity) [TVEpisodeEntity](/docs/170-core-entity-schemas#tvepisodeentity) [PlaylistEntity](/docs/170-core-entity-schemas#playlistentity) [MusicEntity](/docs/170-core-entity-schemas#musicentity) [AdditionalEntity](/docs/170-core-entity-schemas#additionalentity)

---