GET

Launch Instance

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/fa000ea1-ce9e-49d9-b676-d6ba61b82e15/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "fa000ea1-ce9e-49d9-b676-d6ba61b82e15",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/fa000ea1-ce9e-49d9-b676-d6ba61b82e15/?format=api",
    "slug": "angara-12pp-maiden-flight-suborbital",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Angara-1.2pp | Maiden flight (Suborbital)",
    "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-07-08T05:29:49Z",
    "updates": [],
    "net": "2014-07-09T12:00:00Z",
    "net_precision": null,
    "window_end": "2014-07-09T12:00:00Z",
    "window_start": "2014-07-09T12:00:00Z",
    "probability": -1,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 96,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/96/?format=api",
        "name": "Khrunichev State Research and Production Space Center",
        "featured": true,
        "type": "Government",
        "country_code": "RUS",
        "abbrev": "KhSC",
        "description": "Khrunichev State Research and Production Space Center is a Moscow-based producer of spacecraft and space-launch systems, including the Proton and Rokot rockets and is currently developing the Angara rocket family. The Proton launch vehicle launches from Baikonur and Rokot launches from Baikonur and Plesetsk. Angara will launch from Plesetsk and Vostochny.",
        "administrator": "Director: Andrey Vladimirovich Kalinovskiy",
        "founding_year": "1916",
        "launchers": "Proton | Rokot",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 196,
        "consecutive_successful_launches": 7,
        "successful_launches": 181,
        "failed_launches": 15,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.khrunichev.ru/main.php?lang=en",
        "wiki_url": "http://en.wikipedia.org/wiki/Khrunichev_State_Research_and_Production_Space_Center",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg"
    },
    "rocket": {
        "id": 1768,
        "configuration": {
            "id": 53,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/53/?format=api",
            "name": "Angara-1.2pp",
            "active": false,
            "reusable": false,
            "description": "The Angara 1.2pp was a customized Angara 1.2 that was flown once for a sub-orbital test launch.",
            "family": "Angara",
            "full_name": "Angara 1.2pp",
            "manufacturer": {
                "id": 96,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/96/?format=api",
                "name": "Khrunichev State Research and Production Space Center",
                "featured": true,
                "type": "Government",
                "country_code": "RUS",
                "abbrev": "KhSC",
                "description": "Khrunichev State Research and Production Space Center is a Moscow-based producer of spacecraft and space-launch systems, including the Proton and Rokot rockets and is currently developing the Angara rocket family. The Proton launch vehicle launches from Baikonur and Rokot launches from Baikonur and Plesetsk. Angara will launch from Plesetsk and Vostochny.",
                "administrator": "Director: Andrey Vladimirovich Kalinovskiy",
                "founding_year": "1916",
                "launchers": "Proton | Rokot",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 196,
                "consecutive_successful_launches": 7,
                "successful_launches": 181,
                "failed_launches": 15,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.khrunichev.ru/main.php?lang=en",
                "wiki_url": "http://en.wikipedia.org/wiki/Khrunichev_State_Research_and_Production_Space_Center",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg"
            },
            "program": [],
            "variant": "1.2pp",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 40.4,
            "diameter": 2.9,
            "maiden_flight": "2014-07-09",
            "launch_cost": "31000000",
            "launch_mass": 172,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": 1920,
            "apogee": 200,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara-1.2pp_image_20190630234801.jpg",
            "info_url": "http://www.ilslaunch.com/node/4680",
            "wiki_url": "https://en.wikipedia.org/wiki/Angara-1.2pp",
            "total_launch_count": 1,
            "consecutive_successful_launches": 1,
            "successful_launches": 1,
            "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": null,
    "pad": {
        "id": 42,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/42/?format=api",
        "agency_id": 163,
        "name": "35/1",
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Plesetsk_Cosmodrome_Site_35",
        "map_url": "https://www.google.com/maps?q=62.927319,40.574897",
        "latitude": "62.927319",
        "longitude": "40.574897",
        "location": {
            "id": 6,
            "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api",
            "name": "Plesetsk Cosmodrome, Russian Federation",
            "country_code": "RUS",
            "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg",
            "timezone_name": "Europe/Moscow",
            "total_launch_count": 1674,
            "total_landing_count": 0
        },
        "country_code": "RUS",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_42_20200803143543.jpg",
        "total_launch_count": 8,
        "orbital_launch_attempt_count": 8
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Пуск РН Ангара-1.2ПП",
            "description": "Первый испытательный пуск РН \"Ангара-1.2ПП\" 9 июля 2014 года 16:04, космодром Плесецк.",
            "feature_image": "https://i.ytimg.com/vi/Ut03r1N7Xg0/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=Ut03r1N7Xg0",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara-1.2pp_image_20190630234801.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5388,
    "location_launch_attempt_count": 1599,
    "pad_launch_attempt_count": 1,
    "agency_launch_attempt_count": 168,
    "orbital_launch_attempt_count_year": 5388,
    "location_launch_attempt_count_year": 6,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 4,
    "pad_turnaround": "P0D",
    "mission_patches": [],
    "type": "detailed"
}