{"openapi":"3.0.1","info":{"description":"This is the specification for the Audio on Demand API. \n\n","version":"1.0.0","title":"Audio on Demand API"},"tags":[{"name":"Series","description":"Podcast series"},{"name":"Episodes","description":"Podcast episodes"}],"servers":[{"url":"https://api.audio.gracenote.com/podcasts/v1.0"}],"paths":{"/series":{"get":{"tags":["Series"],"summary":"Get podcast series","description":"Use this URI to fetch podcast series. The __seriesIDs__ query parameter takes precedence over other non-paging query parameters. Results are limited to a maximum of 100 per page, as indicated below.","operationId":"searchPodcastSeries","parameters":[{"name":"apiKey","in":"query","description":"API key provided during registration.","required":true,"schema":{"type":"string"}},{"name":"seriesIDs","in":"query","description":"Comma-delimited list of series IDs for which to return episodes.  Takes precedence over all other non-paging query parameters. __(Max = 100)__.","required":false,"schema":{"type":"string"}},{"name":"seriesRootIDs","in":"query","description":"Comma-delimited list of series root IDs __(Max = 100)__. Query returns all the series that have one of the given series root IDs. A logical 'AND' is performed among each set of keyword-value pairs, if any other keyword is also given along with seriesRootIDs.","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Text search on the __title__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'title' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"subtitle","in":"query","description":"Text search on the __subtitle__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'subtitle' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"description","in":"query","description":"Text search on the __description__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'description' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"summary","in":"query","description":"Text search on the __summary__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'summary' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"creditName","in":"query","description":"Text search on the __creditsName__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'credits' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"creditPersonID","in":"query","description":"Text search on the __creditPersonID__ field of the series object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'creditPersonID' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"explicitLanguage","in":"query","description":"Include explicit content","required":false,"schema":{"type":"boolean"}},{"name":"categories","in":"query","description":"Comma-delimited list of categories in the format of __Gracenote Descriptor IDs__.  For a description of available categories, use the __/categories__ API call.  The query performs a logical 'OR' for each set of values passed with one 'categories' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"style":"form","explode":false,"schema":{"type":"string"}},{"name":"language","in":"query","description":"Language of the series. ISO 639-1 format.","required":false,"schema":{"type":"string"}},{"name":"minLastPublishDateTime","in":"query","description":"Date-range specifier for the earliest date that an episode was last published. Format is ISO 8601 in UTC: __yyyy-mm-ddThh:mm:ssZ__.","required":false,"schema":{"type":"string"}},{"name":"maxLastPublishDateTime","in":"query","description":"Date-range specifier for the latest date that an episode was last published. Format is ISO 8601 in UTC: __yyyy-mm-ddThh:mm:ssZ__.","required":false,"schema":{"type":"string"}},{"name":"minLastUpdateDateTime","in":"query","description":"Date-range specifier for the earliest date that the series was last updated. Format is ISO 8601 in UTC: __yyyy-mm-ddThh:mm:ssZ__.","required":false,"schema":{"type":"string"}},{"name":"maxLastUpdateDateTime","in":"query","description":"Date-range specifier for the latest date that the series was last updated. Format is ISO 8601 in UTC: __yyyy-mm-ddThh:mm:ssZ__.","required":false,"schema":{"type":"string"}},{"name":"minAvgEpisodeDurationSeconds","in":"query","description":"Minimum average episode duration for a series (in seconds)","required":false,"schema":{"type":"integer"}},{"name":"maxAvgEpisodeDurationSeconds","in":"query","description":"Maximum average episode duration for a series (in seconds)","required":false,"schema":{"type":"integer"}},{"name":"sort","in":"query","description":"Comma-delimited hierarchy of parameters by which to sort. Ascending order is used unless the parameter is prefixed by \"-\" to denote descending order. Available parameters are `globalPopularity` (worldwide), `ukPopularity` (United Kingdom), `dePopularity` (Germany), `usPopularity` (United States), `caPopularity` (Canada), `auPopularity` (Australia), `esPopularity` (Spain), `mxPopularity` (Mexico), `frPopularity` (France), `atPopularity` (Austria), `chPopularity` (Switzerland), `itPopularity` (Italy), `krPopularity` (Korea), `numEpisodes`, and `lastPublishDateTime`.","required":false,"style":"form","explode":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum number of results to return per page (1-100). __Does not apply to lookup by seriesIDs.__","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","description":"Index of first result from the list to return. 0-based.  __Does not apply to lookup by seriesIDs.__","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Valid response object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validSeriesResponse"},"example":{"meta":{"total":0,"count":0,"offset":0},"data":[{"avgEpisodeDurationSeconds":0,"categories":[[{"descriptorID":"string","display":"string","level":0}]],"credits":[{"name":"string","personID":"string","role":{"display":"string"}}],"country":"string","description":"string","editorialStatus":"string","availabilities":[{"license":"string","name":"string"}],"language":"string","lastPublishDateTime":"string","numEpisodes":0,"objectType":"string","popularity":{"at":0,"au":0,"ca":0,"ch":0,"de":0,"es":0,"fr":0,"global":0,"it":0,"kr":0,"mx":0,"uk":0,"us":0},"recommendedPodcastSeries":["string"],"sourceFeed":{"author":"string","categories":["string"],"contentType":"string","copyright":"string","description":"string","explicitLanguage":true,"feedUrl":"string","generator":"string","imageUrl":"string","language":"string","owner":"string","websiteUrl":"string","keywords":["string"]},"seriesID":"string","seriesRootID":"string","subtitle":"string","summary":"string","title":"string","lastUpdateDateTime":"string"}]}}}},"400":{"$ref":"#/components/responses/errorResponse400"},"401":{"$ref":"#/components/responses/errorResponse401"},"403":{"$ref":"#/components/responses/errorResponse403"},"404":{"$ref":"#/components/responses/errorResponse404"},"413":{"$ref":"#/components/responses/errorResponse413"},"429":{"$ref":"#/components/responses/errorResponse429"}}}},"/episodes":{"get":{"tags":["Episodes"],"summary":"Get episodes of podcast series","description":"Use this URI to fetch podcast episodes. The __episodeIDs__ and __seriesIDs__ query parameters are mutually exclusive and both take precedence over other non-paging query parameters. Results are limited to a maximum of 100 per page, as indicated below.","operationId":"searchPodcastEpisodes","parameters":[{"name":"apiKey","in":"query","description":"API key provided during registration.","required":true,"schema":{"type":"string"}},{"name":"episodeIDs","in":"query","description":"Comma-delimited list of episode IDs for which to return episodes. __(Max = 100)__.","required":false,"schema":{"type":"string"}},{"name":"seriesIDs","in":"query","description":"Comma-delimited list of series IDs for which to return episodes. __(Max = 100)__.","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Text search on the __title__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'title' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"subtitle","in":"query","description":"Text search on the __subtitle__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'subtitle' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"description","in":"query","description":"Text search on the __description__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'description' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"summary","in":"query","description":"Text search on the __summary__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'summary' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"creditName","in":"query","description":"Text search on the __creditName__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'creditName' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"creditPersonID","in":"query","description":"Text search on the __creditPersonId__ field of the episode object. This keyword can be used multiple __(Max = 5x)__ times. The query performs a logical 'OR' for each set of values passed with one 'creditPersonID' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"schema":{"type":"string"}},{"name":"explicitLanguage","in":"query","description":"Include explicit content","required":false,"schema":{"type":"boolean"}},{"name":"categories","in":"query","description":"Comma-delimited list of categories in the format of __Gracenote Descriptor IDs__.  For a description of available categories, use the __/categories__ API call.  The query performs a logical 'OR' for each set of values passed with one 'categories' parameter; a logical 'AND' is performed among each set of keyword-value pairs.","required":false,"style":"form","explode":false,"schema":{"type":"string"}},{"name":"language","in":"query","description":"Language of the episode. ISO 639-1 format.","required":false,"schema":{"type":"string"}},{"name":"minPublishDateTime","in":"query","description":"Date-range specifier for earliest episode release date. Use ISO 8601 format in UTC: __yyyy-mm-ddThh:mm:ssZ__. Use this method to return all episodes released after the specified date and time. Specify a date and time before the current date and time.","required":false,"schema":{"type":"string"}},{"name":"maxPublishDateTime","in":"query","description":"A date-range specifier for the most recent episode release date. Use ISO 8601 format in UTC: __yyyy-mm-ddThh:mm:ssZ__. Use this method to return all episodes released before the specified date and time. Specify a date and time before the current date and time.","required":false,"schema":{"type":"string"}},{"name":"minLastUpdateDateTime","in":"query","description":"A date-range specifier for the earliest date that an episode was last updated. Use ISO 8601 format in UTC: __yyyy-mm-ddThh:mm:ssZ__. Use this method to return all episodes updated after the specified date and time. Updates can include things like duration updates, metadata updates, changes from open to licensed, provider exclusive, etc. Specify a date and time before the current date and time.","required":false,"schema":{"type":"string"}},{"name":"maxLastUpdateDateTime","in":"query","description":"Date-range specifier for the most recent date that an episode was updated. Use ISO 8601 format in UTC: __yyyy-mm-ddThh:mm:ssZ__. Use this method to return all episodes updated before the specified date and time. Updates can include things like duration updates, metadata updates, changes from open to licensed, provider exclusive, etc. Specify a date and time before the current date and time.","required":false,"schema":{"type":"string"}},{"name":"minEpisodeDurationSeconds","in":"query","description":"Minimum duration, in seconds, of episodes to return.","required":false,"schema":{"type":"integer"}},{"name":"maxEpisodeDurationSeconds","in":"query","description":"Maximum duration, in seconds, of episodes to return.","required":false,"schema":{"type":"integer"}},{"name":"sort","in":"query","description":"Comma-delimited hierarchy of fields by which to sort.  Ascending order is used unless the parameter is prefixed by \"-\" to denote descending order. Fields are `publishDateTime` and `durationSeconds`.","required":false,"style":"form","explode":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum number of results to return per page (1-100). __Does not apply to lookups using episode IDs.__","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","description":"Index of the first episode in the list of results to return. 0-based. __Does not apply to lookups by episode IDs.__","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Valid response object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validEpisodeResponse"},"example":{"meta":{"total":0,"count":0,"offset":0},"data":[{"audioEnclosure":{"audioUrl":"string","mimeType":"string","sizeBytes":0},"availabilities":[{"license":"string","name":"string"}],"categories":[[{"descriptorID":"string","display":"string","level":0}]],"credits":[{"name":"string","personID":"string","role":{"display":"string"}}],"description":"string","durationSeconds":0,"episodeID":"string","episodeNumber":0,"objectType":"string","publishDateTime":"string","sourceFeed":{"description":"string","episodeType":"string","explicitLanguage":false,"imageUrl":"string","websiteUrl":"string","guid":"string"},"seasonNumber":0,"seriesReference":{"href":"string","seriesID":"string","title":"string"},"subtitle":"string","summary":"string","title":"string","lastUpdateDateTime":"string","editorialStatus":"string","language":"string"}]}}}},"400":{"$ref":"#/components/responses/errorResponse400"},"401":{"$ref":"#/components/responses/errorResponse401"},"403":{"$ref":"#/components/responses/errorResponse403"},"404":{"$ref":"#/components/responses/errorResponse404"},"413":{"$ref":"#/components/responses/errorResponse413"},"429":{"$ref":"#/components/responses/errorResponse429"}}}},"/categories":{"get":{"tags":["Categories"],"summary":"Get hierarchical Audio on Demand Category listing","description":"Use this URI to retrieve the hierarchical list of Gracenote Category Descriptor IDs that are used to annotate `series` and `episodes` objects and their descriptive strings. All Category descriptor objects are returned in a single response page.","operationId":"lookupCategories","parameters":[{"name":"apiKey","in":"query","description":"API key provided during registration.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Valid response object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/validCategoriesResponse"},"example":{"meta":{"total":0,"count":0,"offset":0},"data":[{"language":"string","list":"string","revision":"string","children":[{"descriptorID":"string","display":"string","level":0,"children":[{"descriptorID":"string","display":"string","level":0,"children":[{"descriptorID":"string","display":"string","level":0}]}]}]}]}}}},"400":{"$ref":"#/components/responses/errorResponse400"},"401":{"$ref":"#/components/responses/errorResponse401"},"403":{"$ref":"#/components/responses/errorResponse403"},"404":{"$ref":"#/components/responses/errorResponse404"},"413":{"$ref":"#/components/responses/errorResponse413"},"429":{"$ref":"#/components/responses/errorResponse429"}}}}},"components":{"schemas":{"errorResponse":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"status":{"type":"integer","nullable":false,"description":"(non-nullable)"},"error":{"type":"string","nullable":false,"description":"(non-nullable)"},"description":{"type":"string","nullable":false,"description":"(non-nullable)"}},"required":["status","error","description"]},"responseMeta":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"total":{"type":"integer","nullable":false,"description":"(non-nullable)"},"count":{"type":"integer","nullable":false,"description":"(non-nullable)"},"offset":{"type":"integer","nullable":false,"description":"(non-nullable)"}},"required":["total","count","offset"]},"validSeriesResponse":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"meta":{"$ref":"#/components/schemas/responseMeta"},"data":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/series"}}},"required":["meta","data"]},"validEpisodeResponse":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"meta":{"$ref":"#/components/schemas/responseMeta"},"data":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/episode"}}},"required":["meta","data"]},"validCategoriesResponse":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"meta":{"$ref":"#/components/schemas/responseMeta"},"data":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/list"}}},"required":["meta","data"]},"series":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"categories":{"type":"array","nullable":false,"additionalProperties":false,"description":"(non-nullable, 0-n elements)","items":{"type":"array","nullable":false,"additionalProperties":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/descriptorObject"}}},"availabilities":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/availabilities"}},"avgEpisodeDurationSeconds":{"type":"integer","nullable":true,"description":"(nullable)"},"credits":{"$ref":"#/components/schemas/credits"},"country":{"type":"string","nullable":true,"description":"(nullable)"},"description":{"type":"string","nullable":true,"description":"(nullable)"},"editorialStatus":{"type":"string","enum":["original","enhanced"],"nullable":false,"description":"(non-nullable)"},"language":{"type":"string","nullable":true,"description":"(nullable)"},"lastPublishDateTime":{"type":"string","format":"date-time","nullable":true,"description":"(nullable)"},"numEpisodes":{"type":"integer","nullable":true,"description":"(nullable)"},"objectType":{"type":"string","enum":["series"],"nullable":false,"description":"(non-nullable)"},"popularity":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"at":{"type":"number","nullable":true,"description":"(nullable)"},"au":{"type":"number","nullable":true,"description":"(nullable)"},"ca":{"type":"number","nullable":true,"description":"(nullable)"},"ch":{"type":"number","nullable":true,"description":"(nullable)"},"de":{"type":"number","nullable":true,"description":"(nullable)"},"es":{"type":"number","nullable":true,"description":"(nullable)"},"fr":{"type":"number","nullable":true,"description":"(nullable)"},"global":{"type":"number","nullable":true,"description":"(nullable)"},"it":{"type":"number","nullable":true,"description":"(nullable)"},"kr":{"type":"number","nullable":true,"description":"(nullable)"},"mx":{"type":"number","nullable":true,"description":"(nullable)"},"uk":{"type":"number","nullable":true,"description":"(nullable)"},"us":{"type":"number","nullable":true,"description":"(nullable)"}},"required":["at","au","ca","ch","de","es","fr","global","it","kr","mx","uk","us"]},"recommendedPodcastSeries":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"string"}},"sourceFeed":{"$ref":"#/components/schemas/sourceFeedSeries"},"seriesID":{"type":"string","nullable":false,"pattern":"^GA[0-9a-zA-Z]{13}","description":"(non-nullable)"},"seriesRootID":{"type":"string","nullable":false,"pattern":"^GA[0-9a-zA-Z]{13}","description":"(non-nullable)"},"subtitle":{"type":"string","nullable":true,"description":"(nullable)"},"summary":{"type":"string","nullable":true,"description":"(nullable)"},"title":{"type":"string","nullable":true,"description":"(nullable)"},"lastUpdateDateTime":{"type":"string","format":"date-time","nullable":false,"description":"(non-nullable)"}},"required":["categories","availabilities","avgEpisodeDurationSeconds","credits","country","description","editorialStatus","language","lastPublishDateTime","numEpisodes","objectType","popularity","recommendedPodcastSeries","sourceFeed","seriesID","seriesRootID","subtitle","summary","title","lastUpdateDateTime"]},"episode":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"audioEnclosure":{"$ref":"#/components/schemas/audioEnclosure"},"categories":{"type":"array","nullable":false,"additionalProperties":false,"description":"(non-nullable, 0-n elements)","items":{"type":"array","nullable":false,"additionalProperties":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/descriptorObject"}}},"availabilities":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"$ref":"#/components/schemas/availabilities"}},"credits":{"$ref":"#/components/schemas/credits"},"description":{"type":"string","nullable":true,"description":"(nullable)"},"durationSeconds":{"type":"integer","nullable":true,"description":"(nullable)"},"episodeID":{"type":"string","nullable":false,"pattern":"^GA[0-9a-zA-Z]{13}","description":"(non-nullable)"},"episodeNumber":{"type":"integer","nullable":true,"description":"(nullable)"},"objectType":{"type":"string","enum":["episode"],"nullable":false,"description":"(non-nullable)"},"publishDateTime":{"type":"string","format":"date-time","nullable":true,"description":"(nullable)"},"sourceFeed":{"$ref":"#/components/schemas/sourceFeedEpisodes"},"seasonNumber":{"type":"integer","nullable":true,"description":"(nullable)"},"seriesReference":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"href":{"type":"string","nullable":true,"description":"(nullable)"},"seriesID":{"type":"string","nullable":false,"pattern":"^GA[0-9a-zA-Z]{13}","description":"(non-nullable)"},"title":{"type":"string","nullable":true,"description":"(nullable)"}},"required":["href","seriesID","title"]},"subtitle":{"type":"string","nullable":true,"description":"(nullable)"},"summary":{"type":"string","nullable":true,"description":"(nullable)"},"title":{"type":"string","nullable":true,"description":"(nullable)"},"lastUpdateDateTime":{"type":"string","format":"date-time","nullable":false,"description":"(non-nullable)"},"editorialStatus":{"type":"string","enum":["original","enhanced"],"nullable":false,"description":"(non-nullable)"},"language":{"type":"string","nullable":true,"description":"(nullable)"}},"required":["audioEnclosure","categories","availabilities","credits","description","durationSeconds","episodeID","episodeNumber","objectType","publishDateTime","sourceFeed","seasonNumber","seriesReference","subtitle","summary","title","lastUpdateDateTime","editorialStatus","language"]},"audioEnclosure":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"audioUrl":{"type":"string","nullable":true,"description":"(nullable)"},"mimeType":{"type":"string","nullable":true,"description":"(nullable)"},"sizeBytes":{"type":"integer","nullable":true,"description":"(nullable)"}},"required":["audioUrl","mimeType","sizeBytes"]},"list":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"language":{"type":"string","nullable":false,"description":"(non-nullable)"},"list":{"type":"string","nullable":false,"description":"(non-nullable)"},"revision":{"type":"string","nullable":false,"description":"(non-nullable)"},"children":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"descriptorID":{"type":"string","nullable":false,"description":"(non-nullable)"},"display":{"type":"string","nullable":false,"description":"(non-nullable)"},"level":{"type":"integer","enum":[1],"nullable":false,"description":"(non-nullable)"},"children":{"type":"array","nullable":false,"description":"(non-nullable. 0-n elements)","items":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"descriptorID":{"type":"string","nullable":false,"description":"(non-nullable)"},"display":{"type":"string","nullable":false,"description":"(non-nullable)"},"level":{"type":"integer","enum":[2],"nullable":false,"description":"(non-nullable)"},"children":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"descriptorID":{"type":"string","nullable":false,"description":"(non-nullable)"},"display":{"type":"string","nullable":false,"description":"(non-nullable)"},"level":{"type":"integer","enum":[3],"nullable":false,"description":"(non-nullable)"},"children":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"string","nullable":false,"description":"(non-nullable)"}}},"required":["descriptorID","display","level"]}}},"required":["descriptorID","display","level","children"]}}},"required":["descriptorID","display","level","children"]}}},"required":["language","list","revision","children"]},"credits":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"role":{"$ref":"#/components/schemas/descriptorObjectRole"},"name":{"type":"string","nullable":true,"description":"(nullable)"},"personID":{"type":"string","nullable":true,"description":"(nullable)"}},"required":["role","name","personID"]}},"descriptorObject":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"descriptorID":{"type":"string","nullable":false,"description":"(non-nullable)"},"display":{"type":"string","nullable":false,"description":"(non-nullable)"},"level":{"type":"integer","nullable":false,"enum":[1,2,3],"description":"(non-nullable)"}},"required":["descriptorID","display","level"]},"descriptorObjectRole":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"display":{"type":"string","nullable":false,"description":"(non-nullable)"}},"required":["display"]},"availabilities":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"license":{"type":"string","nullable":false,"description":"(non-nullable)"},"name":{"type":"string","nullable":false,"description":"(non-nullable)"}},"required":["license","name"]},"sourceFeedSeries":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"author":{"type":"string","nullable":true,"description":"(nullable)"},"categories":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"string"}},"contentType":{"type":"string","nullable":true,"description":"(nullable)"},"copyright":{"type":"string","nullable":true,"description":"(nullable)"},"description":{"type":"string","nullable":true,"description":"(nullable)"},"explicitLanguage":{"type":"boolean","nullable":true,"description":"(nullable)"},"feedUrl":{"type":"string","nullable":true,"description":"(nullable)"},"generator":{"type":"string","nullable":true,"description":"(nullable)"},"imageUrl":{"type":"string","nullable":true,"description":"(nullable)"},"language":{"type":"string","nullable":true,"description":"(nullable)"},"owner":{"type":"string","nullable":true,"description":"(nullable)"},"websiteUrl":{"type":"string","nullable":true,"description":"(nullable)"},"keywords":{"type":"array","nullable":false,"description":"(non-nullable, 0-n elements)","items":{"type":"string"}}},"required":["author","categories","contentType","copyright","description","explicitLanguage","feedUrl","generator","imageUrl","language","owner","websiteUrl","keywords"]},"sourceFeedEpisodes":{"type":"object","nullable":false,"additionalProperties":false,"description":"(non-nullable)","properties":{"description":{"type":"string","nullable":true,"description":"(nullable)"},"episodeType":{"type":"string","nullable":true,"description":"(nullable)"},"explicitLanguage":{"type":"boolean","nullable":true,"description":"(nullable)"},"guid":{"type":"string","nullable":true,"description":"(nullable)"},"imageUrl":{"type":"string","nullable":true,"description":"(nullable)"},"websiteUrl":{"type":"string","nullable":true,"description":"(nullable)"}},"required":["description","episodeType","explicitLanguage","guid","imageUrl","websiteUrl"]}},"responses":{"errorResponse400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":400,"error":"invalid_query_parameter_value","description":"Data Type Error: explicitLanguage must be of type boolean."}}}},"errorResponse401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":400,"error":"unauthorized_missing_apikey","description":"API key is required."}}}},"errorResponse403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":403,"error":"plan_limit_exceeded","description":"Number of queries exceeds plan limit."}}}},"errorResponse404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":404,"error":"resource_not_found","description":"Parameter given is not found."}}}},"errorResponse413":{"description":"Payload Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":413,"error":"request_too_large","description":"Size of request exceeds 3MB."}}}},"errorResponse429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorResponse"},"example":{"status":429,"error":"rate_limit_exceeded","description":"Number of queries per minute exceeds limit."}}}}}}}