--- title: "GET /seasons/upcoming" method: GET path: "/seasons/upcoming" tags: ["seasons"] --- # GET /seasons/upcoming `GET /seasons/upcoming` ## Request - Base URL: `https://api.jikan.moe/v4` - URL: `https://api.jikan.moe/v4/seasons/upcoming` - Auth: none declared ## Query parameters - `filter` 'tv' | 'movie' | 'ova' | 'special' | 'ona' | 'music' - `sfw` boolean - `unapproved` boolean - `continuing` boolean - `page` integer - `limit` integer ## Response `200` Returns upcoming season's anime - AnimeSearch: Anime Collection Resource - `data` Anime[] - `mal_id` integer: MyAnimeList ID - `url` string: MyAnimeList URL - `images` AnimeImages - `jpg` object: Available images in JPG - `image_url` string, nullable: Image URL JPG - `small_image_url` string, nullable: Small Image URL JPG - `large_image_url` string, nullable: Image URL JPG - `webp` object: Available images in WEBP - `image_url` string, nullable: Image URL WEBP - `small_image_url` string, nullable: Small Image URL WEBP - `large_image_url` string, nullable: Image URL WEBP - `trailer` TrailerBase: Youtube Details - `youtube_id` string, nullable: YouTube ID - `url` string, nullable: YouTube URL - `embed_url` string, nullable: Parsed Embed URL - `approved` boolean: Whether the entry is pending approval on MAL or not - `titles` Title[]: All titles - `type` string: Title type - `title` string: Title value - `title` string: Title - `title_english` string, nullable: English Title - `title_japanese` string, nullable: Japanese Title - `title_synonyms` string[]: Other Titles - `type` 'TV' | 'OVA' | 'Movie' | 'Special' | 'ONA' | 'Music' | 'CM' | 'PV' | 'TV Special': Anime Type - `source` string, nullable: Original Material/Source adapted from - `episodes` integer, nullable: Episode count - `status` 'Finished Airing' | 'Currently Airing' | 'Not yet aired', nullable: Airing status - `airing` boolean: Airing boolean - `aired` Daterange: Date range - `from` string, nullable: Date ISO8601 - `to` string, nullable: Date ISO8601 - `prop` object: Date Prop - `from` object: Date Prop From - `day` integer, nullable: Day - `month` integer, nullable: Month - `year` integer, nullable: Year - `to` object: Date Prop To - `day` integer, nullable: Day - `month` integer, nullable: Month - `year` integer, nullable: Year - `string` string, nullable: Raw parsed string - `duration` string, nullable: Parsed raw duration - `rating` 'G - All Ages' | 'PG - Children' | 'PG-13 - Teens 13 or older' | 'R - 17+ (violence & profanity)' | 'R+ - Mild Nudity' | 'Rx - Hentai', nullable: Anime audience rating - `score` number, float, nullable: Score - `scored_by` integer, nullable: Number of users - `rank` integer, nullable: Ranking - `popularity` integer, nullable: Popularity - `members` integer, nullable: Number of users who have added this entry to their list - `favorites` integer, nullable: Number of users who have favorited this entry - `synopsis` string, nullable: Synopsis - `background` string, nullable: Background - `season` 'summer' | 'winter' | 'spring' | 'fall', nullable: Season - `year` integer, nullable: Year - `broadcast` Broadcast: Broadcast Details - `day` string, nullable: Day of the week - `time` string, nullable: Time in 24 hour format - `timezone` string, nullable: Timezone (Tz Database format https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) - `string` string, nullable: Raw parsed broadcast string - `producers` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `licensors` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `studios` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `genres` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `explicit_genres` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `themes` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `demographics` MalUrl[] - `mal_id` integer: MyAnimeList ID - `type` string: Type of resource - `name` string: Resource Name/Title - `url` string: MyAnimeList URL - `pagination` object - `last_visible_page` integer - `has_next_page` boolean - `current_page` integer - `items` object - `count` integer - `total` integer - `per_page` integer ## Other responses - `400`: Error: Bad request. When required parameters were not supplied. ## Changes - **2026-05-24** `ae6dd9d554d6`: 1 breaking, 7 info - the `allOf[subschema #1]/data/items/type` response's property type changed from `string` to no type for status `200` - added `#/components/schemas/anime_types` to the `allOf[subschema #1]/data/items/type` response property `allOf` list for the response status `200` - removed the `Movie` enum value from the `allOf[subschema #1]/data/items/type` response property for the response status `200` - removed the `Music` enum value from the `allOf[subschema #1]/data/items/type` response property for the response status `200` - …4 more - **2025-04-17** `b0fa1e34a3f0`: 1 info - added the optional property `allOf[#/components/schemas/pagination_plus]/pagination/current_page` to the response with the `200` status - **2024-06-27** `1e1f26cfee2f`: 1 info - added the new optional `query` request parameter `continuing` - **2023-06-02** `4ab3f5f5aa00`: 2 info - added the new optional `query` request parameter `sfw` - added the new optional `query` request parameter `unapproved` - **2023-06-02** `e5c562e7ba46`: 1 info - added the new optional `query` request parameter `limit` [Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/seasons/upcoming/get.md) --- [API](https://skmtc.dev/jikan/apis/jikan-api.md) - [All operations](https://skmtc.dev/jikan/apis/jikan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jikan/apis/jikan-api/revisions/ae6dd9d554d6?raw)