Modes

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

Example - /events/?mode=list

Filters

Parameters - agency__ids, date__gt, date__gt__lt, date__gte, 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

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/1194/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 1194,
    "url": "https://lldev.thespacedevs.com/2.3.0/events/1194/?format=api",
    "name": "Shenzhou 19 Landing",
    "info_urls": [],
    "vid_urls": [
        {
            "priority": 10,
            "source": null,
            "publisher": "CGTN",
            "title": "Live: Special coverage of Shenzhou-19 crew's return to Earth",
            "description": "CGTN brings the special coverage of the Shenzhou-19 crew's return to the Dongfeng Landing Site in north China's Inner Mongolia Autonomous Region. The crew – Cai Xuzhe, Song Lingdong and Wang Haoze – c...",
            "feature_image": "https://i.ytimg.com/vi/BGFjZYxrJ8I/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=BGFjZYxrJ8I",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2025-04-30T04:14:42Z",
            "end_time": "2025-04-30T06:14:24Z",
            "live": false
        }
    ],
    "image": {
        "id": 1260,
        "name": "[AUTO] Shenzhou 16 Landing - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_16_lan_image_20231027084649.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.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-04-30T05:04:00Z",
    "slug": "shenzhou-19-landing",
    "type": {
        "id": 9,
        "name": "Spacecraft Landing"
    },
    "description": "The Shenzhou 19 Descent Capsule will land in the desert near Jiuquan Satellite Launch Center, China, bringing Cai Xuzhe, Song Lingdong and Wang Haozhe back to Earth after spending six months in orbit as part of the eighth mission to the Chinese Space Station.",
    "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": null,
    "updates": [
        {
            "id": 10865,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Webcast live. Reentry underway.",
            "info_url": "https://www.youtube.com/watch?v=BGFjZYxrJ8I",
            "created_by": "hitura-nobad",
            "created_on": "2025-04-30T04:47:00Z"
        },
        {
            "id": 10752,
            "profile_image": "https://thespacedevs-prod.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.msg2680274#msg2680274",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-04-18T08:41:00Z"
        },
        {
            "id": 10847,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Apparently delayed due to landing site weather conditions.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=59864.msg2682103#msg2682103",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-04-29T00:08:00Z"
        },
        {
            "id": 10850,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for April 30 per NOTAMs.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2682296#msg2682296",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-04-29T01:16:00Z"
        }
    ],
    "last_updated": "2025-04-30T04:47:51Z",
    "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": "28c2b327-bb20-452d-b1df-c100265d6aa5",
            "url": "https://lldev.thespacedevs.com/2.3.0/launches/28c2b327-bb20-452d-b1df-c100265d6aa5/?format=api",
            "name": "Long March 2F/G | Shenzhou 19",
            "response_mode": "list",
            "slug": "long-march-2fg-shenzhou-19",
            "launch_designator": "2024-194",
            "status": {
                "id": 3,
                "name": "Launch Successful",
                "abbrev": "Success",
                "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
            },
            "last_updated": "2024-10-30T08:39:36Z",
            "net": "2024-10-29T20:27:34Z",
            "net_precision": {
                "id": 0,
                "name": "Second",
                "abbrev": "SEC",
                "description": "The T-0 is accurate to the second."
            },
            "window_end": "2024-10-29T20:57:00Z",
            "window_start": "2024-10-29T20:17:00Z",
            "image": {
                "id": 1765,
                "name": "[AUTO] Long March 2 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193714.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "infographic": null
        }
    ],
    "expeditions": [
        {
            "id": 161,
            "url": "https://lldev.thespacedevs.com/2.3.0/expeditions/161/?format=api",
            "name": "Shenzhou 19",
            "start": "2024-10-30T03:00:00Z",
            "end": "2025-04-29T20:00: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-prod.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png",
                    "thumbnail_url": "https://thespacedevs-prod.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": 1063,
                    "name": "Shenzhou 19 Patch",
                    "priority": 10,
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/shenzhou252019_mission_patch_20241030083558.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": 481,
                    "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/481/?format=api",
                    "name": "Shenzhou 19 EVA 1b",
                    "start": "2024-12-17T06:32:00Z",
                    "end": "2024-12-17T13:57:00Z",
                    "duration": "PT7H25M",
                    "location": "Tiangong Space Station"
                },
                {
                    "response_mode": "list",
                    "id": 480,
                    "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/480/?format=api",
                    "name": "Shenzhou 19 EVA 1a",
                    "start": "2024-12-17T04:51:00Z",
                    "end": "2024-12-17T13:57:00Z",
                    "duration": "PT9H6M",
                    "location": "Tiangong Space Station"
                },
                {
                    "response_mode": "list",
                    "id": 483,
                    "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/483/?format=api",
                    "name": "Shenzhou 19 EVA 2",
                    "start": "2025-01-20T08:55:00Z",
                    "end": "2025-01-20T17:12:00Z",
                    "duration": "PT8H17M",
                    "location": "Tiangong Space Station"
                },
                {
                    "response_mode": "list",
                    "id": 485,
                    "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/485/?format=api",
                    "name": "Shenzhou 19 EVA 3",
                    "start": "2025-03-21T05:50:00Z",
                    "end": "2025-03-21T12:50:00Z",
                    "duration": "PT7H",
                    "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-prod.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png",
                "thumbnail_url": "https://thespacedevs-prod.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-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_program_20200820204745.PNG",
                "thumbnail_url": "https://thespacedevs-prod.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-prod.nyc3.digitaloceanspaces.com/media/images/chinese2520spa_program_20210608105528.png",
                "thumbnail_url": "https://thespacedevs-prod.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": []
}