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 - ll.thespacedevs.com/docs

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

{
    "id": 327,
    "url": "https://ll.thespacedevs.com/2.3.0/events/327/?format=api",
    "name": "Shenzhou 12 Landing",
    "info_urls": [],
    "vid_urls": [
        {
            "priority": 10,
            "source": "www.youtube.com",
            "publisher": null,
            "title": "Live: Chinese astronauts to return home after 3-month space mission",
            "description": "Chinese astronauts Nie Haisheng, Liu Boming and Tang Hongbo embark on the voyage home after the Shenzhou-12 spaceship completed circumnavigation and radial r...",
            "feature_image": "https://i.ytimg.com/vi/I0p3P3vErDQ/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=I0p3P3vErDQ",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": null,
            "end_time": null,
            "live": false
        }
    ],
    "image": {
        "id": 1054,
        "name": "[AUTO] Shenzhou 12 Landing - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_12_lan_image_20210915224539.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191510.jpeg",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": false,
        "variants": []
    },
    "date": "2021-09-17T05:30:00Z",
    "slug": "shenzhou-12-landing",
    "type": {
        "id": 9,
        "name": "Spacecraft Landing"
    },
    "description": "The Shenzhou 12 Descent Capsule will land in the desert near Jiuquan Satellite Launch Center, China, bringing Nie Haisheng, Liu Boming, and Tang Hongbo back to Earth after spending three months in orbit as part of the first mission to the Chinese Space Station.",
    "webcast_live": false,
    "location": "Near Jiuquan Satellite Launch Center, China",
    "date_precision": null,
    "response_mode": "detailed",
    "duration": null,
    "updates": [
        {
            "id": 822,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added landing per NOTAMs.",
            "info_url": "https://twitter.com/aj_fi/status/1438051033540874241?s=21",
            "created_by": "Cosmic_Penguin",
            "created_on": "2021-09-15T09:55:53Z"
        }
    ],
    "last_updated": "2024-03-05T17:29:13Z",
    "agencies": [],
    "launches": [
        {
            "id": "5c1c76b1-fe29-4b3f-97d0-c35695d5fbd0",
            "url": "https://ll.thespacedevs.com/2.3.0/launches/5c1c76b1-fe29-4b3f-97d0-c35695d5fbd0/?format=api",
            "name": "Long March 2F/G | Shenzhou 12",
            "response_mode": "list",
            "slug": "long-march-2fg-shenzhou-12",
            "launch_designator": "2021-053",
            "status": {
                "id": 3,
                "name": "Launch Successful",
                "abbrev": "Success",
                "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
            },
            "last_updated": "2023-10-25T10:59:44Z",
            "net": "2021-06-17T01:22:31Z",
            "net_precision": null,
            "window_end": "2021-06-17T01:54:00Z",
            "window_start": "2021-06-17T01:13: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": 145,
            "url": "https://ll.thespacedevs.com/2.3.0/expeditions/145/?format=api",
            "name": "Shenzhou 12",
            "start": "2021-06-17T07:54:00Z",
            "end": "2021-09-17T05:34:00Z",
            "response_mode": "normal",
            "spacestation": {
                "id": 18,
                "url": "https://ll.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": 8,
                    "name": "China Shenzhou 12 Mission Patch",
                    "priority": 10,
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/china2520shenz_mission_patch_20210606212146.png",
                    "agency": {
                        "response_mode": "list",
                        "id": 17,
                        "url": "https://ll.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": 452,
                    "url": "https://ll.thespacedevs.com/2.3.0/spacewalks/452/?format=api",
                    "name": "Shenzhou 12 EVA 2",
                    "start": "2021-08-20T00:38:00Z",
                    "end": "2021-08-20T06:33:00Z",
                    "duration": "PT5H55M",
                    "location": "Tiangong Space Station"
                },
                {
                    "response_mode": "list",
                    "id": 451,
                    "url": "https://ll.thespacedevs.com/2.3.0/spacewalks/451/?format=api",
                    "name": "Shenzhou 12 EVA 1",
                    "start": "2021-07-04T00:11:00Z",
                    "end": "2021-07-04T06:57:00Z",
                    "duration": "PT6H46M",
                    "location": "Tiangong Space Station"
                }
            ]
        }
    ],
    "spacestations": [
        {
            "id": 18,
            "url": "https://ll.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://ll.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://ll.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://ll.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://ll.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": []
}