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, expedition__ids, id, last_updated__gte, last_updated__lte, launch__ids, month, program, program__ids, slug, spacestation__ids, 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/1317/?format=api
{ "id": 1317, "url": "https://lldev.thespacedevs.com/2.3.0/events/1317/?format=api", "name": "Shenzhou 20 Landing", "info_urls": [], "vid_urls": [], "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": "2026-01-19T01:30:00Z", "slug": "shenzhou-20-landing", "type": { "id": 9, "name": "Spacecraft Landing" }, "description": "The Shenzhou 20 Descent Capsule will land in the desert near Jiuquan Satellite Launch Center, China, after it was deemed not usable with crew for re-entry in November 2025 due to orbital debris damaging its Descent Module port hole window. The spacecraft will carry various cargo of opportunity from the Chinese Space Station back to Earth.", "webcast_live": false, "location": "Near Jiuquan Satellite Launch Center, China", "date_precision": { "id": 2, "name": "Hour", "abbrev": "HR", "description": "The T-0 is accurate to the hour." }, "response_mode": "detailed", "duration": null, "updates": [ { "id": 13646, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added landing per NOTAMs.", "info_url": "https://x.com/AJ_FI/status/2011392472791023711", "created_by": "Cosmic_Penguin", "created_on": "2026-01-15T02:53:00Z" } ], "last_updated": "2026-01-15T02:53:32Z", "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": "a164daf8-31df-4d34-bf67-5ec41b3a9f9b", "url": "https://lldev.thespacedevs.com/2.3.0/launches/a164daf8-31df-4d34-bf67-5ec41b3a9f9b/?format=api", "name": "Long March 2F/G | Shenzhou 20", "response_mode": "list", "slug": "long-march-2fg-shenzhou-20", "launch_designator": "2025-082", "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-04-24T21:32:20Z", "net": "2025-04-24T09:17:31Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-04-24T09:47:00Z", "window_start": "2025-04-24T09:07: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": "2025-11-14T03:14:00Z", "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": [] }
