Content markup properties of live TV events

This section provides the details of the content markup properties for the BroadcastEvent, SportsEvent, MusicEvent, and Event entity types.

BroadcastEvent specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}]
  • Replace xx with the entity's language code in BCP 47 format format, for example, "en".
@type Text Required - Always set to BroadcastEvent.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's url meets all the requirements as an identifier, we recommend you use an entity's url as @id. See the Identifier section for more details.
name Text Required - The title of the show or event.
description Text The description of the show or event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
startDate Date Required - The start time of the event in ISO 8601 format with time zone.
endDate Date The end time of the event in ISO 8601 format with time zone.
publishedOn BroadcastService Required if applicable - Specify the BroadcastService entity that broadcasts this show or event.

If the content is broadcast on a TV channel, this property is required. If the content is not associated with any TV channel, do not provide this property.
publishedOn.@type Text Set to BroadcastService.
publishedOn.@id URL The @id of the BroadcastService entity that broadcasts this show or event.
workPerformed CreativeWork Required if applicable - Use this property when the content is one of the following entity types: Movie, TVSeries, TVSeason, and TVEpisode.

A BroadcastEvent entity must have either a workPerformed or broadcastOfEvent property.
workPerformed.@type Text Set to Movie, TVSeries, TVSeason, or TVEpisode.
workPerformed.@id URL The @id of the content entity.
broadcastOfEvent Event, MusicEvent, or SportsEvent Required if applicable - Use this property if the content is a live event:
  • For a sports event, this property needs to refer to a SportsEvent entity.
  • For a music event, this property needs to refer to a MusicEvent entity.
  • For other event types, this property needs to refer to a generic Event entity.
A BroadcastEvent entity must have either a workPerformed or broadcastOfEvent property.
broadcastOfEvent.@type Text Set to SportsEvent, MusicEvent, or Event.
broadcastOfEvent.@id URL The @id of the event entity.
videoFormat Text The highest quality definition supported on this broadcast service; for example,
  • "SD" for standard-definition.
  • "HD" for high-definition.
  • "2K" for 2K resolution.
  • "4K" for 4K resolution.
  • "8K" for 8K resolution.
isLiveBroadcast Boolean Set to True if this is a live event; for example, a sports event or a concert.
potentialAction WatchAction Required if applicable - If the content is broadcast as a live streaming event, use this property to provide the deep link of the event.

BroadcastEvent example

A TV episode is broadcast on the television network Example TV (BroadcastService) between 9 pm and 9:30 pm on October 12th, 2019:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "Name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "Description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "authenticator": {
          "@type": "Organization",
          "name": "TVE"
        }
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

SportsEvent specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}]
  • Replace xx with the entity's language code; for example, "en".
@type Text Required - Always set to SportsEvent.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's url meets all the requirements as an identifier, we recommend you use an entity's url as @id. See the Identifier section for more details.
name Text Required - The name of this event.
description Text The description of this event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
startDate Date Required - The start time of the event in ISO 8601 format with time zone.
endDate Date The end time of the event in ISO 8601 format with time zone.
homeTeam SportsTeam The home team of the event.
homeTeam.name Text The full name of the sports team.
homeTeam.sport URL A link to the English Wikipedia page of the sport.
homeTeam.memberOf SportsOrganization The league of the sports team.
homeTeam.athlete Person Annotation(s) for an individual athlete on the team.
homeTeam.athlete.name Text The full name of the athlete.
awayTeam SportsTeam The away team of the event. The properties are the same as SportsEvent.homeTeam.
competitor SportsTeam or Person If the home or away team is not applicable (e.g., a boxing match, the Olympics), specify the participants as competitors. If SportsTeam, the properties are the same as SportsEvent.homeTeam. If Person, the properties are the same as other Person objects; for instance, an actor in Movie.
location Place The location of the event. Note that you can provide Place in City level.
location.name Text The name of the location.
location.address PostalAddress The address of the location. If you provide Place in City level, do not use this.
location.address.streetAddress Text The street address of the location.
location.address.addressLocality Text The city of the location.
location.address.addressRegion Text The state of the location.
location.address.postalCode Text The postal code of the location.
location.address.addressCountry Text The countries in ISO 3166 format.
image ImageObject Image(s) related to the event. Recommended to be the official poster or banner art for the event. Provide the highest resolution available. Use a JPEG or PNG file format.
image.description Text The description of the image. 300-character limit. Use an array to provide the descriptions in multiple languages and lengths.
image.contentUrl URL A URL where the image can be fetched.
image.regionsAllowed Place The regions where the image is allowed. If the image is allowed everywhere, do not provide this. Specify the countries in ISO 3166 format.
potentialAction WatchAction The deep link that plays the recording of this sports event on Video on Demand. To specify the deep link for a live event, use the publishedOn or potentialAction property in BroadcastEvent instead.

SportsEvent examples

A professional basketball league’s championship game is broadcast live on the television network Example TV (BroadcastService):

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/basketball/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "startDate":"2019-06-16T20:00-08:00",
  "endDate":"2019-06-16T23:00-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "publishedOn":{
    "@type":"BroadcastService",
    "@id":"http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type":"SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  }
}

SportsEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "memberOf":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    },
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "memberOf":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    },
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "authenticator": {
          "@type": "Organization",
          "name": "TVE"
        }
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

A popular boxing match is broadcast live on the Internet as a streaming event (WatchAction):

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/20190616/johndoe_vs_janedoe",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "startDate":"2019-06-16T21:00-08:00",
  "endDate":"2019-06-16T21:30-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "broadcastOfEvent": {
    "@type":"SportsEvent",
    "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/premium/johndoe_vs_janedoe",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2019-06-01T10:00:00Z",
      "availabilityEnds": "2019-06-31T10:00:00Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/premium_subscription",
        "name": "Example Premium",
        "sameAs": "http://www.example.com/premium_subscription"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  }
}

SportsEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

MusicEvent specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}]
  • Replace xx with the entity's language code in BCP 47 format format, for example, "en".
@type Text Required - Always set to MusicEvent.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's url meets all the requirements as an identifier, we recommend you use an entity's url as @id. See the Identifier section for more details.
name Text Required - The name of this event.
description Text The description of the event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
attendee Organization or Person A person or organization attending the event.
startDate Date Required - The start time of the event in ISO 8601 format with time zone.
endDate Date The end time of the event in ISO 8601 format with time zone.
composer Organization or Person The person or organization who wrote a composition, or who is the composer of a work performed at some event.
performer Organization or Person A performer at the event—for example, a presenter, a musician, musical group or actor.
subEvent Event An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference.
superEvent Event An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
location Place The location of the event. Note that you can provide Place in City level.
location.name Text The name of the location.
location.address PostalAddress The address of the location. If you provide Place in City level, do not use this.
location.address.streetAddress Text The street address of the location.
location.address.addressLocality Text The city of the location.
location.address.addressRegion Text The state of the location.
location.address.postalCode Text The postal code of the location.
location.address.addressCountry Text The countries in ISO 3166 format.
workPerformed CreativeWork A work performed in some event, for example a play performed in a TheaterEvent.

MusicEvent example

A musical concert is broadcast live on the television network Example TV (BroadcastService):

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_artist_2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "startDate":"2019-06-16T21:00-08:00",
  "endDate":"2019-06-16T21:30-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "publishedOn":{
    "@type":"BroadcastService",
    "@id":"http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type":"MusicEvent",
    "@id": "http://example.com/music/my_favortie_artist/2019_tour"
  }
}

MusicEvent

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "authenticator": {
          "@type": "Organization",
          "name": "TVE"
        }
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Event specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}]
  • Replace xx with the entity's language code in BCP 47 format format, for example, "en".
@type Text Required - Always set to Event.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's url meets all the requirements as an identifier, we recommend you use an entity's url as @id. See the Identifier section for more details.
name Text Required - The name of this event.
description Text The description of the event. 300-character limist. Use an array to include the descriptions in multiple languages and lengths.
attendee Organization or Person A person or organization attending the event.
startDate Date Required - The start time of the event in ISO 8601 format with time zone.
endDate Date The end time of the event in ISO 8601 format with time zone.
subEvent Event An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference.
superEvent Event An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
location Place The location of the event. Note that you can provide Place in City level.
location.name Text The name of the location.
location.address PostalAddress The address of the location. If you provide Place in City level, do not use this.
location.address.streetAddress Text The street address of the location.
location.address.addressLocality Text The city of the location.
location.address.addressRegion Text The state of the location.
location.address.postalCode Text The postal code of the location.
location.address.addressCountry Text The countries in ISO 3166 format.
workPerformed CreativeWork A work performed in some event, for example a play performed in a TheaterEvent.

Event example

The Google I/O 2019 keynote is broadcast live on the Internet as a streaming event (WatchAction).

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"BroadcastEvent",
  "@id": "http://example.com/live/event/google_io_2019/keynote",
  "name":"Google I/O 2019 keynote",
  "startDate":"2019-05-07T10:00-08:00",
  "endDate":"2019-05-07T12:00-08:00",
  "videoFormat":"HD",
  "isLiveBroadcast":"True",
  "broadcastOfEvent": {
    "@type":"Event",
    "@id": "http://example.com/keynote/google_io_2019"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/conference/google_io_2019",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2019-05-01T10:00:00Z",
      "availabilityEnds": "2019-05-31T10:00:00Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/basic_subscription",
        "name": "Example Basic",
        "sameAs": "http://www.example.com/basic_subscription"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  }
}

Event

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}

Check out the following pages for the topics related to these properties: