Modes

Levels of detail in the response - list, normal, detailed

Example - /events/upcoming/?mode=list

Filters

Parameters - agency__ids, date__gt, date__gt__lt, date__gte, date__lte, day, hide_recent_previous, id, last_updated__gte, last_updated__lte, month, program, slug, type, type__ids, video_url, year

Example - /events/upcoming/?type__ids=2,8

Fields searched - name

Example - /events/upcoming/?search=Flyby

Ordering

Fields - date, last_updated

Example - /events/upcoming/?ordering=-last_updated

Number of results

Use limit to control the number of objects in the response (max 100)

Example - /events/upcoming/?limit=2

Format

Switch to JSON output - /events/upcoming/?format=json

Help

Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs

GET /2.3.0/events/upcoming/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 30,
    "next": "https://lldev.thespacedevs.com/2.3.0/events/upcoming/?format=api&limit=10&offset=10",
    "previous": null,
    "results": [
        {
            "id": 1192,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1192/?format=api",
            "name": "Soyuz MS-26 Farewell Ceremony & Hatch Closing",
            "info_urls": [],
            "vid_urls": [
                {
                    "priority": 10,
                    "source": "plus.nasa.gov",
                    "publisher": "NASA",
                    "title": "Soyuz MS-26 Space Station Farewells and Hatch Close",
                    "description": "Coverage of the Hatch Closing of the Soyuz MS-26 Spacecraft at the International Space Station (Hatch Closing expected at appx. 2:25 p.m. EDT).",
                    "feature_image": "https://plus.nasa.gov/wp-content/uploads/2025/04/soyuz-ms-26-farewells-and-hatch-closing-key-art-r2-horizontal-program-tile-16-9-without-title.jpg",
                    "url": "https://plus.nasa.gov/scheduled-video/soyuz-ms-26-space-station-farewells-and-hatch-close/",
                    "type": {
                        "id": 1,
                        "name": "Official Webcast"
                    },
                    "language": {
                        "id": 1,
                        "name": "English",
                        "code": "en"
                    },
                    "start_time": "2025-04-19T18:00:00Z",
                    "end_time": "2025-04-19T20:00:00Z",
                    "live": false
                }
            ],
            "image": {
                "id": 967,
                "name": "Soyuz MS in orbit (MS-19)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg",
                "credit": "ESA/NASA/T. Pesquet",
                "license": {
                    "id": 2,
                    "name": "ESA Standard Licence",
                    "priority": 2,
                    "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-04-19T18:00:00Z",
            "slug": "soyuz-ms-26-farewell-ceremony-hatch-closing",
            "type": {
                "id": 17,
                "name": "Farewell Ceremony"
            },
            "description": "NASA will livestream the farewell ceremony and hatch closing of the Soyuz MS-26 crew ahead of its return to Earth.",
            "webcast_live": false,
            "location": "International Space Station",
            "date_precision": {
                "id": 1,
                "name": "Minute",
                "abbrev": "MIN",
                "description": "The T-0 is accurate to the minute."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [
                {
                    "id": 10665,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
                    "comment": "Adding event",
                    "info_url": "https://plus.nasa.gov/scheduled-video/soyuz-ms-26-space-station-farewells-and-hatch-close/",
                    "created_by": "Nosu",
                    "created_on": "2025-04-09T18:49:00Z"
                }
            ],
            "last_updated": "2025-04-09T18:49:30Z"
        },
        {
            "id": 1189,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1189/?format=api",
            "name": "Soyuz MS-26 Undocking",
            "info_urls": [],
            "vid_urls": [
                {
                    "priority": 10,
                    "source": "plus.nasa.gov",
                    "publisher": "NASA",
                    "title": "Soyuz MS-26 Undocking",
                    "description": "Coverage of the Undocking of the Soyuz MS-26 Spacecraft from the International Space Station (Pettit, Ovchinin, Vagner; undocking scheduled at 5:57 p.m. EDT).",
                    "feature_image": "https://plus.nasa.gov/wp-content/uploads/2025/04/soyuz-ms-26-undocking-key-art-r2-horizontal-program-tile-16-9-without-title.jpg",
                    "url": "https://plus.nasa.gov/scheduled-video/soyuz-ms-26-undocking/",
                    "type": {
                        "id": 1,
                        "name": "Official Webcast"
                    },
                    "language": {
                        "id": 1,
                        "name": "English",
                        "code": "en"
                    },
                    "start_time": "2025-04-19T21:30:00Z",
                    "end_time": "2025-04-19T23:30:00Z",
                    "live": false
                }
            ],
            "image": {
                "id": 967,
                "name": "Soyuz MS in orbit (MS-19)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg",
                "credit": "ESA/NASA/T. Pesquet",
                "license": {
                    "id": 2,
                    "name": "ESA Standard Licence",
                    "priority": 2,
                    "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-04-19T21:55:30Z",
            "slug": "soyuz-ms-26-undocking",
            "type": {
                "id": 8,
                "name": "Spacecraft Undocking"
            },
            "description": "The Soyuz MS-26 spacecraft will undock from the International Space Station ahead of reentry and landing in Kazakhstan.",
            "webcast_live": false,
            "location": "International Space Station",
            "date_precision": {
                "id": 0,
                "name": "Second",
                "abbrev": "SEC",
                "description": "The T-0 is accurate to the second."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [
                {
                    "id": 10654,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
                    "comment": "Adding event",
                    "info_url": "https://nasa-public-data.s3.amazonaws.com/iss-coords/current/ISS_OEM/ISS.OEM_J2K_EPH.txt",
                    "created_by": "Nosu",
                    "created_on": "2025-04-08T21:20:00Z"
                }
            ],
            "last_updated": "2025-04-09T15:51:33Z"
        },
        {
            "id": 397,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/397/?format=api",
            "name": "Lucy Main Belt Asteroid (52246) Donaldjohansen Flyby",
            "info_urls": [
                {
                    "priority": 10,
                    "source": "lucy.swri.edu",
                    "title": "Lucy Mission",
                    "description": "\n• Construction and testing of the L'LORRI Instrument is completed at APL and it is delivered to Lockheed Martin\n• Construction and testing of the L'TES Instrument is completed at ASU and it is delivered to Lockheed Martin\n• Construction and testing of the L'Ralph Instrument is completed at NASA God...",
                    "feature_image": null,
                    "url": "http://lucy.swri.edu/timeline.html",
                    "type": null,
                    "language": {
                        "id": 1,
                        "name": "English",
                        "code": "en"
                    }
                }
            ],
            "vid_urls": [],
            "image": {
                "id": 1004,
                "name": "Lucy in space render",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/lucy_earth_flyb_image_20210930111825.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191348.jpeg",
                "credit": "NASA",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-04-20T00:00:00Z",
            "slug": "lucy-main-belt-asteroid-52246-donaldjohansen-flyby",
            "type": {
                "id": 23,
                "name": "Flyby"
            },
            "description": "Flyby of the main belt asteroid (52246) Donaldjohansen asteroid by NASA's Lucy mission.",
            "webcast_live": false,
            "location": "(52246) Donaldjohansen",
            "date_precision": null,
            "response_mode": "normal",
            "duration": null,
            "updates": [],
            "last_updated": "2024-03-05T17:26:11Z"
        },
        {
            "id": 1191,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1191/?format=api",
            "name": "Soyuz MS-26 Landing",
            "info_urls": [],
            "vid_urls": [
                {
                    "priority": 10,
                    "source": "plus.nasa.gov",
                    "publisher": "NASA",
                    "title": "Soyuz MS-26 Re-entry and Landing with Don Pettit",
                    "description": "Coverage of the Deorbit Burn and Landing of the Soyuz MS-26 Spacecraft in Kazakhstan (Pettit, Ovchinin, Vagner; deorbit burn scheduled at 8:23 p.m. EDT; landing near Dzhezkazgan, Kazakhstan scheduled at 9:17 p.m. EDT).",
                    "feature_image": "https://plus.nasa.gov/wp-content/uploads/2025/04/soyuz-ms-26-reentry-and-landing-key-art-r2-horizontal-hero-16-9-without-title.jpg",
                    "url": "https://plus.nasa.gov/scheduled-video/soyuz-ms-26-re-entry-and-landing-with-don-pettit/",
                    "type": {
                        "id": 1,
                        "name": "Official Webcast"
                    },
                    "language": {
                        "id": 1,
                        "name": "English",
                        "code": "en"
                    },
                    "start_time": "2025-04-20T00:00:00Z",
                    "end_time": "2025-04-20T02:00:00Z",
                    "live": false
                }
            ],
            "image": {
                "id": 1056,
                "name": "Soyuz MS landing (MS-04)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520ms-122520landing_image_20190929074125.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191514.jpeg",
                "credit": "NASA/Bill Ingalls",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-04-20T01:17:00Z",
            "slug": "soyuz-ms-26-landing",
            "type": {
                "id": 9,
                "name": "Spacecraft Landing"
            },
            "description": "The Soyuz MS-26 spacecraft will land back on Earth near Dzhezkazgan, Kazakhstan.",
            "webcast_live": false,
            "location": "Dzhezkazgan, Kazakhstan",
            "date_precision": {
                "id": 1,
                "name": "Minute",
                "abbrev": "MIN",
                "description": "The T-0 is accurate to the minute."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [
                {
                    "id": 10661,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
                    "comment": "Added Event!",
                    "info_url": "https://plus.nasa.gov/scheduled-video/soyuz-ms-26-re-entry-and-landing-with-don-pettit/",
                    "created_by": "hitura-nobad",
                    "created_on": "2025-04-09T15:54:00Z"
                }
            ],
            "last_updated": "2025-04-09T18:50:46Z"
        },
        {
            "id": 1190,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1190/?format=api",
            "name": "CRS-32 Dragon Docking",
            "info_urls": [],
            "vid_urls": [],
            "image": {
                "id": 1086,
                "name": "Cargo Dragon docking",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/crs-28_dragon_d_image_20230530191602.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191606.jpeg",
                "credit": "NASA",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-04-22T11:47:07Z",
            "slug": "crs-32-dragon-docking",
            "type": {
                "id": 2,
                "name": "Docking"
            },
            "description": "Following its launch atop a Falcon 9, the CRS-32 Dragon will autonomously dock to the ISS, bringing crew supplies as well as experiments.",
            "webcast_live": false,
            "location": "International Space Station",
            "date_precision": {
                "id": 0,
                "name": "Second",
                "abbrev": "SEC",
                "description": "The T-0 is accurate to the second."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [
                {
                    "id": 10656,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
                    "comment": "Adding event",
                    "info_url": "https://nasa-public-data.s3.amazonaws.com/iss-coords/current/ISS_OEM/ISS.OEM_J2K_EPH.txt",
                    "created_by": "Nosu",
                    "created_on": "2025-04-08T21:24:00Z"
                }
            ],
            "last_updated": "2025-04-08T21:24:07Z"
        },
        {
            "id": 1111,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1111/?format=api",
            "name": "Hakuto-R M2 Lunar Landing",
            "info_urls": [],
            "vid_urls": [],
            "image": {
                "id": 2310,
                "name": "Render of Hakuto-R M2 & rover on the Moon",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/render_of_hakut_image_20250115080142.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/render_of_hakut_image_thumbnail_20250115080142.png",
                "credit": "ispace",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-06-05T19:24:00Z",
            "slug": "hakuto-r-m2-lunar-landing",
            "type": {
                "id": 7,
                "name": "Moon Landing"
            },
            "description": "Japanese company ispace's Hakuto-R Mission 2 lander will attempt a lunar landing in Mare Frigoris.",
            "webcast_live": false,
            "location": "Mare Frigoris, Moon",
            "date_precision": {
                "id": 1,
                "name": "Minute",
                "abbrev": "MIN",
                "description": "The T-0 is accurate to the minute."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [
                {
                    "id": 10274,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
                    "comment": "Updated landing date.",
                    "info_url": "https://x.com/jeff_foust/status/1896726242285797438",
                    "created_by": "Cosmic_Penguin",
                    "created_on": "2025-03-04T01:01:00Z"
                },
                {
                    "id": 9810,
                    "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
                    "comment": "Adding event",
                    "info_url": "https://ispace-inc.com/news-en/?p=6565",
                    "created_by": "Nosu",
                    "created_on": "2025-01-15T08:02:00Z"
                }
            ],
            "last_updated": "2025-03-04T01:01:38Z"
        },
        {
            "id": 1016,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/1016/?format=api",
            "name": "Juice Venus Flyby",
            "info_urls": [
                {
                    "priority": 10,
                    "source": "www.esa.int",
                    "title": "ESA’s Juice lifts off on quest to discover secrets of Jupiter’s icy moons",
                    "description": "ESA’s Jupiter Icy Moons Explorer (Juice) lifted off on an Ariane 5 rocket from Europe’s Spaceport in French Guiana at 14:14 CEST on 14 April. The successful launch marks the beginning of an ambitious voyage to uncover the secrets of the ocean worlds around giant planet Jupiter.",
                    "feature_image": null,
                    "url": "https://www.esa.int/Science_Exploration/Space_Science/Juice/ESA_s_Juice_lifts_off_on_quest_to_discover_secrets_of_Jupiter_s_icy_moons",
                    "type": {
                        "id": 1,
                        "name": "Official Page"
                    },
                    "language": {
                        "id": 1,
                        "name": "English",
                        "code": "en"
                    }
                }
            ],
            "vid_urls": [],
            "image": {
                "id": 1035,
                "name": "JUICE render",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_20240307192047.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240307192048.jpeg",
                "credit": "spacecraft: ESA/ATG medialab; Jupiter: NASA/ESA/J. Nichols (University of Leicester); Ganymede: NASA/JPL; Io: NASA/JPL/University of Arizona; Callisto and Europa: NASA/JPL/DLR",
                "license": {
                    "id": 2,
                    "name": "ESA Standard Licence",
                    "priority": 2,
                    "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-08-31T00:00:00Z",
            "slug": "juice-venus-flyby",
            "type": {
                "id": 23,
                "name": "Flyby"
            },
            "description": "Second flyby of ESA's Jupiter Icy Moons Explorer (Juice) mission on its way to the Jovian system.",
            "webcast_live": false,
            "location": "Venus",
            "date_precision": {
                "id": 7,
                "name": "Month",
                "abbrev": "M",
                "description": "The T-0 is expected in the given month."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [],
            "last_updated": "2024-07-15T09:33:06Z"
        },
        {
            "id": 365,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/365/?format=api",
            "name": "Boeing Starliner-1 Docking",
            "info_urls": [],
            "vid_urls": [],
            "image": {
                "id": 1190,
                "name": "Boeing Starliner render",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing2520starliner2520docking_image_20191210170411.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191945.jpeg",
                "credit": "NASA",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-12-31T00:00:00Z",
            "slug": "boeing-starliner-1-docking",
            "type": {
                "id": 2,
                "name": "Docking"
            },
            "description": "The Starliner-1 spacecraft will dock autonomously to the International Space Station, carrying four astronauts to the International Space Station.",
            "webcast_live": false,
            "location": "International Space Station",
            "date_precision": {
                "id": 14,
                "name": "Year",
                "abbrev": "Y",
                "description": "The T-0 is expected in the given year."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [],
            "last_updated": "2025-02-12T03:51:17Z"
        },
        {
            "id": 415,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/415/?format=api",
            "name": "Boeing Starliner-1 Landing",
            "info_urls": [],
            "vid_urls": [],
            "image": {
                "id": 1190,
                "name": "Boeing Starliner render",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing2520starliner2520docking_image_20191210170411.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191945.jpeg",
                "credit": "NASA",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-12-31T00:00:00Z",
            "slug": "boeing-starliner-1-landing",
            "type": {
                "id": 9,
                "name": "Spacecraft Landing"
            },
            "description": "Following its deorbit burn, the Boeing CST-100 Starliner will reenter the Earth's atmosphere and land at the White Sands Missile Range using its parachutes.",
            "webcast_live": false,
            "location": "White Sands Missile Range",
            "date_precision": {
                "id": 14,
                "name": "Year",
                "abbrev": "Y",
                "description": "The T-0 is expected in the given year."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [],
            "last_updated": "2025-02-12T03:51:27Z"
        },
        {
            "id": 414,
            "url": "https://lldev.thespacedevs.com/2.3.0/events/414/?format=api",
            "name": "Boeing Starliner-1 Undocking",
            "info_urls": [],
            "vid_urls": [],
            "image": {
                "id": 1190,
                "name": "Boeing Starliner render",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing2520starliner2520docking_image_20191210170411.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191945.jpeg",
                "credit": "NASA",
                "license": {
                    "id": 4,
                    "name": "NASA Image and Media Guidelines",
                    "priority": 0,
                    "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
                },
                "single_use": false,
                "variants": []
            },
            "date": "2025-12-31T00:00:00Z",
            "slug": "boeing-starliner-1-undocking",
            "type": {
                "id": 8,
                "name": "Spacecraft Undocking"
            },
            "description": "The Boeing CST-100 Starliner will undock from the International Space Station and conduct a deorbit burn as part of its first operational mission.\r\n\r\nFollowing the deorbit burn the capsule will renter the Earth's atmosphere and land at the 'White Sands Missile Range' using its parachutes.",
            "webcast_live": false,
            "location": "International Space Station",
            "date_precision": {
                "id": 14,
                "name": "Year",
                "abbrev": "Y",
                "description": "The T-0 is expected in the given year."
            },
            "response_mode": "normal",
            "duration": null,
            "updates": [],
            "last_updated": "2025-02-12T03:51:39Z"
        }
    ]
}