AN API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX

GET Return a list of all Launch objects.

FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'

MODE 'normal', 'list', 'detailed'

EXAMPLE ?mode=list

SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.

EXAMPLE - ?search=SpaceX

GET /2.2.0/launch/485b9786-5bec-4dd4-ac82-69d1fd702047/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "485b9786-5bec-4dd4-ac82-69d1fd702047",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/485b9786-5bec-4dd4-ac82-69d1fd702047/?format=api",
    "slug": "long-march-5-tianwen-1-mars-global-remote-sensing",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Long March 5 | Tianwen-1 (Mars Global Remote Sensing Orbiter and Small Rover)",
    "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-08-02T17:01:14Z",
    "updates": [],
    "net": "2020-07-23T04:41:15Z",
    "net_precision": null,
    "window_end": "2020-07-23T07:00:00Z",
    "window_start": "2020-07-23T04:00:00Z",
    "probability": -1,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 88,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "featured": true,
        "type": "Government",
        "country_code": "CHN",
        "abbrev": "CASC",
        "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
        "administrator": "Chairman & President: Lei Fanpei",
        "founding_year": "1999",
        "launchers": "Long March",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 518,
        "consecutive_successful_launches": 60,
        "successful_launches": 504,
        "failed_launches": 14,
        "pending_launches": 9,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://english.spacechina.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png"
    },
    "rocket": {
        "id": 158,
        "configuration": {
            "id": 128,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/128/?format=api",
            "name": "Long March 5",
            "active": true,
            "reusable": false,
            "description": "Long March 5 is a Chinese heavy lift launch system developed by China Academy of Launch Vehicle Technology (CALT). CZ-5 is the first Chinese vehicle designed from the ground up to focus on non-hypergolic liquid rocket propellants. Currently, two CZ-5 vehicle configurations are planned, with maximum payload capacities of ~25,000 kilograms (55,000 lb) to LEO and ~14,000 kilograms (31,000 lb) to GTO. The Long March 5 roughly matches the capabilities of American EELV heavy-class vehicles such as the Delta IV Heavy.",
            "family": "Long March",
            "full_name": "Long March 5",
            "manufacturer": {
                "id": 88,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api",
                "name": "China Aerospace Science and Technology Corporation",
                "featured": true,
                "type": "Government",
                "country_code": "CHN",
                "abbrev": "CASC",
                "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
                "administrator": "Chairman & President: Lei Fanpei",
                "founding_year": "1999",
                "launchers": "Long March",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 518,
                "consecutive_successful_launches": 60,
                "successful_launches": 504,
                "failed_launches": 14,
                "pending_launches": 9,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://english.spacechina.com/",
                "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": 57.0,
            "diameter": 5.0,
            "maiden_flight": "2016-11-03",
            "launch_cost": null,
            "launch_mass": 867,
            "leo_capacity": 25000,
            "gto_capacity": 14000,
            "to_thrust": 10600,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_5_image_20231214064353.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Long_March_5",
            "total_launch_count": 6,
            "consecutive_successful_launches": 6,
            "successful_launches": 6,
            "failed_launches": 0,
            "pending_launches": 2,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 759,
        "name": "Tianwen-1 (Mars Global Remote Sensing Orbiter and Small Rover)",
        "description": "Tianwen-1 (\"questions to heaven\") Mars mission includes a Martian orbiter and a lander/rover duo. This will be China's first mission to Mars. \n\nThe spacecraft will reach Mars in February 2021. Lander will remain attached to the orbiter for two to three months before attempting its landing. The chosen landing area is Utopia Planitia, a huge basin formed by a large impact far back in Mars' history. The rover is expected to be in operation for about 90 Martian sols. The Tianwen-1 orbiter will provide a relay communication link to the rover while performing its own scientific observations for one Martian year.\n\nThe orbiter will operate in a polar orbit in order to  map Mars' morphology and geological structure while also using the Mars-Orbiting Subsurface Exploration Radar instrument to investigate soil characteristics and water-ice distribution. It will also measure the ionosphere and the electromagnetic and gravitational fields, the new paper reported. The rover will have 13 instruments detecting things such as topography, soil, environment, atmosphere, water ice, physical field and internal structure. It will investigate the surface soil characteristics and water-ice distribution with its own Subsurface Exploration Radar. It will also analyze surface material composition and characteristics of the Martian climate and environment on the surface.",
        "launch_designator": null,
        "type": "Robotic Exploration",
        "orbit": {
            "id": 6,
            "name": "Heliocentric N/A",
            "abbrev": "Helio-N/A"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 175,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/175/?format=api",
        "agency_id": null,
        "name": "101",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Spacecraft_Launch_Site",
        "map_url": "https://www.google.com/maps?q=19.614334,110.951011",
        "latitude": "19.614334",
        "longitude": "110.951011",
        "location": {
            "id": 8,
            "url": "https://ll.thespacedevs.com/2.2.0/location/8/?format=api",
            "name": "Wenchang Space Launch Site, People's Republic of China",
            "country_code": "CHN",
            "description": "The Wenchang Space Launch Site is a rocket launch site located in Wenchang on the island of Hainan, in China.\r\n\r\nFormally a suborbital test center, it currently serves as China's southernmost spaceport. The site was selected for its low latitude, 19° north of the equator, allowing for larger payloads to be launched. It is capable of launching the Long March 5, the heaviest Chinese rocket. Unlike launch facilities on the mainland, Wenchang uses its seaport for deliveries.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_8_20200803142445.jpg",
            "timezone_name": "Asia/Shanghai",
            "total_launch_count": 37,
            "total_landing_count": 0
        },
        "country_code": "CHN",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_175_20200803143424.jpg",
        "total_launch_count": 13,
        "orbital_launch_attempt_count": 13
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "[回放]中国首次独立火星探测任务(长征五号/天问一号) [Replay] China's first independent Mars mission (LongMarch-5/Tianwen-1)",
            "description": "7月23日,中国火星探测任务“天问一号”在海南文昌卫星发射中心发射升空。这是中国首次执行火星探测任务,任务目标是通过一次发射,实现火星环绕、着陆和巡视探测。 China's Long March-5 Y4 carrier rocket, carrying the Mars probe, blasted off a...",
            "feature_image": "https://i.ytimg.com/vi/LXZnmANq-rw/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=LXZnmANq-rw",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "Tianwen-1 Mars Launch Live Stream",
            "description": "China is targeting 04:00 on 7/23/2020 UTC for liftoff of their Tianwen-1 Mars mission aboard their Long March 5 rocket. If successful, this will be China’s f...",
            "feature_image": "https://i.ytimg.com/vi/gZMAj2aH37g/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=gZMAj2aH37g",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "Live: China's inaugurates first Mars exploration mission Tianwen-1 in southern Hainan Province",
            "description": "2020 can be regarded as the year of Mars. Following Sunday's launch of the UAE's Mars probe, China inaugurates its first Mars exploration mission Tianwen-1 i...",
            "feature_image": "https://i.ytimg.com/vi/V9BsqPqqQbg/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=V9BsqPqqQbg",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "Tianwen-1 Mars Launch Live Stream",
            "description": "China is targeting 04:00 on 7/23/2020 UTC for liftoff of their Tianwen-1 Mars mission aboard their Long March 5 rocket. If successful, this will be China’s f...",
            "feature_image": "https://i.ytimg.com/vi/gZMAj2aH37g/maxresdefault_live.jpg",
            "url": "https://youtu.be/gZMAj2aH37g",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_5_image_20231214064353.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5977,
    "location_launch_attempt_count": 8,
    "pad_launch_attempt_count": 5,
    "agency_launch_attempt_count": 287,
    "orbital_launch_attempt_count_year": 55,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 17,
    "pad_turnaround": "P78DT18H40M48S",
    "mission_patches": [],
    "type": "detailed"
}