Upcoming Event List
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
Search
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 - ll.thespacedevs.com/docs
GET /2.3.0/events/upcoming/?format=api&type__ids=2%2C8
{ "count": 3, "next": null, "previous": null, "results": [ { "id": 1198, "url": "https://ll.thespacedevs.com/2.3.0/events/1198/?format=api", "name": "SpaceX CRS-32 Dragon Undocking", "info_urls": [], "vid_urls": [ { "priority": 10, "source": "plus.nasa.gov", "publisher": "NASA", "title": "NASA’s SpaceX 32nd Commercial Resupply Services Undocking", "description": "Coverage of the Undocking of the SpaceX CRS-32 Dragon Cargo Ship from the International Space Station (Undocking scheduled at 12:05 p.m. EDT).", "feature_image": "https://plus.nasa.gov/wp-content/uploads/2025/05/crs-32-undocking-key-art-r1-horizontal-program-tile-16-9-without-title.jpg", "url": "https://plus.nasa.gov/scheduled-video/nasas-spacex-32nd-commercial-resupply-services-undocking/", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2025-05-22T15:45:00Z", "end_time": "2025-05-22T17:00:00Z", "live": false } ], "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-05-22T16:05:00Z", "slug": "spacex-crs-32-dragon-undocking", "type": { "id": 8, "name": "Spacecraft Undocking" }, "description": "The SpaceX CRS-32 Dragon spacecraft will undock from the International Space Station ahead of its reentry, splashdown and recovery.", "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": 10925, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added undocking.", "info_url": "https://plus.nasa.gov/scheduled-video/nasas-spacex-32nd-commercial-resupply-services-undocking/", "created_by": "Cosmic_Penguin", "created_on": "2025-05-08T19:35:00Z" } ], "last_updated": "2025-05-08T19:35:58Z" }, { "id": 365, "url": "https://ll.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": 414, "url": "https://ll.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" } ] }
