Event Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /events/?mode=list
Filters
Parameters - agency__ids, date__gt, date__gte, date__lt, date__lte, day, id, last_updated__gte, last_updated__lte, month, program, slug, type, type__ids, video_url, year
Example - /events/?type__ids=2,8
Search
Fields searched - name
Example - /events/?search=Flyby
Ordering
Fields - date, last_updated
Example - /events/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /events/?limit=2
Format
Switch to JSON output - /events/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/events/1292/?format=api
{ "id": 1292, "url": "https://lldev.thespacedevs.com/2.3.0/events/1292/?format=api", "name": "Shenzhou 21 Landing", "info_urls": [], "vid_urls": [ { "priority": 10, "source": "youtube.com", "publisher": "CGTN", "title": "Live: Special coverage of Shenzhou-20 crew's return to Earth", "description": "China's Shenzhou-20 crew returns to Earth on Friday aboard the Shenzhou-21 spacecraft. The spacecraft lands at the Dongfeng landing site in north China's Inner Mongolia Autonomous Region. The astronau...", "feature_image": "https://i.ytimg.com/vi/bSme1kHNSN0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=bSme1kHNSN0", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2025-11-14T07:29:59Z", "end_time": "2025-11-14T09:45:55Z", "live": false } ], "image": { "id": 1260, "name": "[AUTO] Shenzhou 16 Landing - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_16_lan_image_20231027084649.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192204.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "date": "2025-11-14T08:30:00Z", "slug": "shenzhou-21-landing", "type": { "id": 9, "name": "Spacecraft Landing" }, "description": "The Shenzhou 21 Descent Capsule will land in the desert near Jiuquan Satellite Launch Center, China, bringing the crew of Shenzhou 20 - Chen Dong, Chen Zhongrui and Wang Jie - back to Earth after spending 6 months in orbit as part of the 9th mission to the Chinese Space Station, and after Shenzhou 20 was possibly struck by orbital debris, rendering it unsuitable for crew re-entry.", "webcast_live": false, "location": "Near Jiuquan Satellite Launch Center, China", "date_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "response_mode": "detailed", "duration": "PT2H15M56S", "updates": [ { "id": 12760, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Landing delayed due to time required to analyze potential orbital debris strike on the spacecraft.", "info_url": "https://m.weibo.cn/detail/5229562801949270", "created_by": "Cosmic_Penguin", "created_on": "2025-11-05T02:37:00Z" }, { "id": 12631, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added landing per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2727261#msg2727261", "created_by": "Cosmic_Penguin", "created_on": "2025-10-20T17:19:00Z" }, { "id": 12863, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated new landing time.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=62256.msg2733644#msg2733644", "created_by": "Cosmic_Penguin", "created_on": "2025-11-12T17:09:00Z" }, { "id": 12878, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated info to reflect swap in spacecraft used for re-entry after possible orbital debris strike on Shenzhou 20.", "info_url": "https://www.news.cn/politics/20251114/98eef6f90c2c4a30b62720b9381442b6/c.html", "created_by": "Cosmic_Penguin", "created_on": "2025-11-14T00:37:00Z" } ], "last_updated": "2025-11-14T09:46:11Z", "agencies": [ { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } } ], "launches": [ { "id": "5ca83f30-9e3d-439c-ac1d-b57953943355", "url": "https://lldev.thespacedevs.com/2.3.0/launches/5ca83f30-9e3d-439c-ac1d-b57953943355/?format=api", "name": "Long March 2F/G | Shenzhou 21", "response_mode": "list", "slug": "long-march-2fg-shenzhou-21", "launch_designator": "2025-246", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-10-31T23:14:14Z", "net": "2025-10-31T15:44:46Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-10-31T16:14:00Z", "window_start": "2025-10-31T15:34:00Z", "image": { "id": 2580, "name": "Shenzhou 22 launch", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_20251129175823.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_thumbnail_20251129175823.jpeg", "credit": "Xinhua", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null } ], "expeditions": [ { "id": 163, "url": "https://lldev.thespacedevs.com/2.3.0/expeditions/163/?format=api", "name": "Shenzhou 20", "start": "2025-04-24T15:49:00Z", "end": null, "response_mode": "normal", "spacestation": { "id": 18, "url": "https://lldev.thespacedevs.com/2.3.0/space_stations/18/?format=api", "name": "Tiangong space station", "image": { "id": 1941, "name": "[AUTO] Tiangong space station - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194211.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "status": { "id": 1, "name": "Active" }, "founded": "2021-04-29", "deorbited": null, "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface. It will be roughly one-fifth the mass of the International Space Station and about the size of the Mir space station.", "orbit": "Low Earth Orbit", "type": { "id": 2, "name": "Government" } }, "mission_patches": [ { "id": 1115, "name": "Shenzhou 20 Patch", "priority": 10, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/mission_patch_images/shenzhou252020_mission_patch_20250322034044.png", "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "response_mode": "normal" } ], "spacewalks": [ { "response_mode": "list", "id": 488, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/488/?format=api", "name": "Shenzhou 20 EVA 2", "start": "2025-06-26T06:59:00Z", "end": "2025-06-26T13:29:00Z", "duration": "PT6H30M", "location": "Tiangong Space Station" }, { "response_mode": "list", "id": 487, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/487/?format=api", "name": "Shenzhou 20 EVA 1", "start": "2025-05-22T00:50:00Z", "end": "2025-05-22T08:49:00Z", "duration": "PT7H59M", "location": "Tiangong Space Station" }, { "response_mode": "list", "id": 489, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/489/?format=api", "name": "Shenzhou 20 EVA 3", "start": "2025-08-15T08:17:00Z", "end": "2025-08-15T14:47:00Z", "duration": "PT6H30M", "location": "Tiangong Space Station" } ] } ], "spacestations": [ { "id": 18, "url": "https://lldev.thespacedevs.com/2.3.0/space_stations/18/?format=api", "name": "Tiangong space station", "image": { "id": 1941, "name": "[AUTO] Tiangong space station - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194211.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "status": { "id": 1, "name": "Active" }, "founded": "2021-04-29", "deorbited": null, "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface. It will be roughly one-fifth the mass of the International Space Station and about the size of the Mir space station.", "orbit": "Low Earth Orbit", "type": { "id": 2, "name": "Government" } } ], "program": [ { "response_mode": "normal", "id": 7, "url": "https://lldev.thespacedevs.com/2.3.0/programs/7/?format=api", "name": "Shenzhou", "image": { "id": 1888, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_program_20200820204745.PNG", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194040.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Shenzhou_program", "description": "The Shenzhou program is a crewed spaceflight initiative by China. The program put the first Chinese citizen, Yang Liwei, into orbit on 15 October 2003.", "agencies": [ { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } } ], "start_date": "1993-01-01T00:00:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "response_mode": "normal", "id": 19, "url": "https://lldev.thespacedevs.com/2.3.0/programs/19/?format=api", "name": "Tiangong space station", "image": { "id": 1893, "name": "[AUTO] Tiangong space station - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chinese2520spa_program_20210608105528.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194050.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Tiangong_space_station", "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface.", "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "start_date": "2021-04-29T03:23:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "astronauts": [] }
