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/63d4405d-f174-4f3a-812a-8351b19cc3ea/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "63d4405d-f174-4f3a-812a-8351b19cc3ea",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/63d4405d-f174-4f3a-812a-8351b19cc3ea/?format=api",
    "slug": "soyuz-stafregat-pleiades-hr-1a-fasat-charlie-ssot",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Soyuz STA/Fregat | Pléiades-HR 1A, FASat-Charlie (SSOT), 4 x ELISA",
    "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-09T19:36:38Z",
    "updates": [],
    "net": "2011-12-17T02:03:08Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2011-12-17T02:03:08Z",
    "window_start": "2011-12-17T02:03:08Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 115,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
        "name": "Arianespace",
        "featured": true,
        "type": "Commercial",
        "country_code": "FRA",
        "abbrev": "ASA",
        "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
        "administrator": "CEO: David Cavaillolès",
        "founding_year": "1980",
        "launchers": "Ariane | Vega",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 319,
        "consecutive_successful_launches": 7,
        "successful_launches": 304,
        "failed_launches": 15,
        "pending_launches": 48,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.arianespace.com",
        "wiki_url": "http://en.wikipedia.org/wiki/Arianespace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg"
    },
    "rocket": {
        "id": 1579,
        "configuration": {
            "id": 49,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/49/?format=api",
            "name": "Soyuz STA",
            "active": true,
            "reusable": false,
            "description": "The 2.1a version includes conversion from analog to digital flight control system and uprated engines on the booster and the first stage with improved injection systems. The new digital flight control and telemetry systems allow the rocket to launch from a fixed rather than angled launch platform and adjust its heading in flight. A digital control system also enables the launch of larger commercial satellites with wider and longer payload fairings such as the ST-type fairing. These fairings introduce too much aerodynamic instability for the old analog system to handle. This stage continues to use the RD-0110 engine.\r\n\r\nThe 2.1a/ST version is sometimes called Soyuz ST-A.",
            "family": "Soyuz",
            "full_name": "Soyuz STA Fregat",
            "manufacturer": {
                "id": 111,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/111/?format=api",
                "name": "Progress Rocket Space Center",
                "featured": false,
                "type": "Commercial",
                "country_code": "RUS",
                "abbrev": "PRSC",
                "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.",
                "administrator": "CEO: Dmitry Baranov",
                "founding_year": "1996",
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 45,
                "consecutive_successful_launches": 3,
                "successful_launches": 44,
                "failed_launches": 1,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://en.samspace.ru/",
                "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png",
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "Fregat",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 46.3,
            "diameter": 2.95,
            "maiden_flight": "2011-12-17",
            "launch_cost": null,
            "launch_mass": 312,
            "leo_capacity": 7020,
            "gto_capacity": 2810,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)",
            "total_launch_count": 8,
            "consecutive_successful_launches": 8,
            "successful_launches": 8,
            "failed_launches": 0,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 7173,
        "name": "Pléiades-HR 1A, FASat-Charlie (SSOT), 4 x ELISA",
        "description": "Pléiades-HR 1A is the first of two high resolution Earth observation satellites designed by the French space agency (CNES) and manufactured by Astrium Satellites. The ELISA mission consists of four satellites manufactured by Astrium Satellites and Thales Systèmes Aéoroportés for the French space agency (CNES) and the French Directorate General of Armament (DGA). SSOT is an Earth observation satellite manufactured by Astrium Satellites for the Chilian armed forces.",
        "launch_designator": null,
        "type": "Government/Top Secret",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [
            {
                "id": 233,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/233/?format=api",
                "name": "Direction générale de l'armement",
                "featured": false,
                "type": "Government",
                "country_code": "FRA",
                "abbrev": "DGA",
                "description": null,
                "administrator": null,
                "founding_year": null,
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/Direction_g%C3%A9n%C3%A9rale_de_l%27armement",
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            },
            {
                "id": 46,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/46/?format=api",
                "name": "National Center of Space Research",
                "featured": false,
                "type": "Government",
                "country_code": "FRA",
                "abbrev": "CNES",
                "description": "The National Center of Space Research, or CNES, is a French National Agency in charge of France's space program. In partnership with the US and Russia, they have put 10 people in space. CNES works in tandem with the larger ESA to develop the Ariane 5 and work on other probes and satellites. They are working with Germany to develop a cheaper and more efficient reusable rocket, which hopefully will be ready to fly by 2026.",
                "administrator": "Interim CEO: Lionel Suchet",
                "founding_year": "1961",
                "launchers": "Ariane 5",
                "spacecraft": "Mars/Venus Express | Rosetta",
                "launch_library_url": null,
                "total_launch_count": 14,
                "consecutive_successful_launches": 3,
                "successful_launches": 12,
                "failed_launches": 2,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.cnes.fr/",
                "wiki_url": "http://en.wikipedia.org/wiki/CNES",
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 81,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/81/?format=api",
        "agency_id": 115,
        "name": "Soyuz Launch Complex",
        "description": "The Ensemble de Lancement Soyouz (ELS)  is a launch complex at the Guiana Space Centre in Kourou/Sinnamary, French Guiana. It was used by Soyuz-ST rockets: modified versions of the Soyuz-2 optimised for launch from Kourou under Soyuz at the Guiana Space Centre programme.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Ensemble_de_Lancement_Soyouz",
        "map_url": "https://www.google.com/maps?q=5.3019,-52.8346",
        "latitude": "5.3019",
        "longitude": "-52.8346",
        "location": {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "timezone_name": "America/Cayenne",
            "total_launch_count": 325,
            "total_landing_count": 0
        },
        "country_code": "GUF",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_81_20200803143601.jpg",
        "total_launch_count": 26,
        "orbital_launch_attempt_count": 26
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Décollage de Soyouz avec Pléiades-1B, le 2 décembre 2012 - Vidéo",
            "description": "Après un report de 24h, la fusée russe a finalement mis en orbite le 2e satellite du système Pléiades, développé par le CNES. Le décollage a eu lieu à 3h02 (heure de Paris) le dimanche 2 décembre 2012. Crédits : CNES. www.cnes.fr",
            "feature_image": "https://s1.dmcdn.net/v/3A6gQ1UJ4Z-M4s6cP/526x297",
            "url": "https://www.dailymotion.com/video/xvjjx6",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "YouTube",
            "description": "",
            "feature_image": null,
            "url": "https://www.youtube.com/watch?v=w2B7oVcS7N8",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [
        {
            "type": {
                "id": 1,
                "abbrev": "GO for Prop Load",
                "description": "Launch director verifies go for propellant load"
            },
            "relative_time": "-PT4H20M"
        },
        {
            "type": {
                "id": 2,
                "abbrev": "Prop Load",
                "description": "Start of propelland loading"
            },
            "relative_time": "-PT4H"
        },
        {
            "type": {
                "id": 134,
                "abbrev": "Prop Load Complete",
                "description": "End of propellant loading"
            },
            "relative_time": "-PT1H45M"
        },
        {
            "type": {
                "id": 142,
                "abbrev": "Mobile Gantry Rollback",
                "description": "Rollback of the mobile gantry from the launch pad"
            },
            "relative_time": "-PT1H"
        },
        {
            "type": {
                "id": 6,
                "abbrev": "Startup",
                "description": "The onboard computer takes control over the countdown and runs last checks"
            },
            "relative_time": "-PT6M10S"
        },
        {
            "type": {
                "id": 143,
                "abbrev": "Fregat Internal Power",
                "description": "Fregat transitions to internal power"
            },
            "relative_time": "-PT5M"
        },
        {
            "type": {
                "id": 144,
                "abbrev": "Umbilicals Separation",
                "description": "Separation of umbilical connections"
            },
            "relative_time": "-PT2M25S"
        },
        {
            "type": {
                "id": 136,
                "abbrev": "Internal Power",
                "description": "Launch vehicle switches to internal power sources"
            },
            "relative_time": "-PT40S"
        },
        {
            "type": {
                "id": 128,
                "abbrev": "Strongback Retract",
                "description": "Retraction of the strongback arm ahead of liftoff"
            },
            "relative_time": "-PT20S"
        },
        {
            "type": {
                "id": 9,
                "abbrev": "Ignition",
                "description": "Start of the engine ignition sequence"
            },
            "relative_time": "-PT17S"
        },
        {
            "type": {
                "id": 145,
                "abbrev": "Preliminary Thrust",
                "description": "Preliminary thrust level achieved by the launch vehicle"
            },
            "relative_time": "-PT15S"
        },
        {
            "type": {
                "id": 146,
                "abbrev": "Full Thrust",
                "description": "Full thrust level achieved by the launch vehicle"
            },
            "relative_time": "-PT3S"
        },
        {
            "type": {
                "id": 10,
                "abbrev": "Liftoff",
                "description": "First upwards movement of the rocket"
            },
            "relative_time": "P0D"
        },
        {
            "type": {
                "id": 111,
                "abbrev": "Boosters Separation",
                "description": "Separation of the side boosters"
            },
            "relative_time": "PT1M58S"
        },
        {
            "type": {
                "id": 15,
                "abbrev": "Fairing Separation",
                "description": "Separation of the payload fairing"
            },
            "relative_time": "PT3M29S"
        },
        {
            "type": {
                "id": 13,
                "abbrev": "Stage 2 Separation",
                "description": "Separation of the second stage from the first"
            },
            "relative_time": "PT4M47S"
        },
        {
            "type": {
                "id": 30,
                "abbrev": "Kick Stage Separation",
                "description": "Separation of the kick stage from the previous stage"
            },
            "relative_time": "PT8M47S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT9M47S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT13M27S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT41M56S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT46M5S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT55M"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT59M5S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT2H3M25S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT2H3M37S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT3H8M37S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT3H8M47S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT3H12M7S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT3H26M"
        }
    ],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5185,
    "location_launch_attempt_count": 215,
    "pad_launch_attempt_count": 2,
    "agency_launch_attempt_count": 201,
    "orbital_launch_attempt_count_year": 79,
    "location_launch_attempt_count_year": 7,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 7,
    "pad_turnaround": "P56DT15H32M42S",
    "mission_patches": [],
    "type": "detailed"
}