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/83e8fa14-0661-489f-baf4-43365fa2fc9c/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "83e8fa14-0661-489f-baf4-43365fa2fc9c",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/83e8fa14-0661-489f-baf4-43365fa2fc9c/?format=api",
    "slug": "soyuz-21afregat-m-kanopus-v-no5-kanopus-v-no6",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Soyuz 2.1a/Fregat-M | Kanopus-V No.5 & Kanopus-V No.6",
    "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-06-15T13:53:09Z",
    "updates": [],
    "net": "2018-12-27T02:07:18Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2018-12-27T02:07:18Z",
    "window_start": "2018-12-27T02:07:18Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 63,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
        "name": "Russian Federal Space Agency (ROSCOSMOS)",
        "featured": true,
        "type": "Government",
        "country_code": "RUS",
        "abbrev": "RFSA",
        "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.",
        "administrator": "Administrator: Yuri Borisov",
        "founding_year": "1992",
        "launchers": "Soyuz",
        "spacecraft": "Soyuz",
        "launch_library_url": null,
        "total_launch_count": 331,
        "consecutive_successful_launches": 55,
        "successful_launches": 320,
        "failed_launches": 11,
        "pending_launches": 10,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://en.roscosmos.ru/",
        "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg"
    },
    "rocket": {
        "id": 51,
        "configuration": {
            "id": 45,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/45/?format=api",
            "name": "Soyuz 2.1a/Fregat-M",
            "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.",
            "family": "Soyuz",
            "full_name": "Soyuz 2.1a Fregat-M",
            "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-M",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 46.3,
            "diameter": 2.95,
            "maiden_flight": "2010-10-19",
            "launch_cost": "80000000",
            "launch_mass": 312,
            "leo_capacity": 7020,
            "gto_capacity": null,
            "to_thrust": 4149,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20190726062341.png",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2",
            "total_launch_count": 19,
            "consecutive_successful_launches": 9,
            "successful_launches": 18,
            "failed_launches": 1,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 35,
        "name": "Kanopus-V No.5 & Kanopus-V No.6",
        "description": "Kanopus-V is a series of Russian Earth observation satellites. They are used for real-time monitoring of natural and man-made emergencies, detecting forest fires, monitoring of land and water resources.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 83,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/83/?format=api",
        "agency_id": 63,
        "name": "Cosmodrome Site 1S",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome",
        "map_url": "https://www.google.com/maps?q=51.884395,128.333932",
        "latitude": "51.884395",
        "longitude": "128.333932",
        "location": {
            "id": 18,
            "url": "https://ll.thespacedevs.com/2.2.0/location/18/?format=api",
            "name": "Vostochny Cosmodrome, Siberia, Russian Federation",
            "country_code": "RUS",
            "description": "The Vostochny Cosmodrome is a Russian spaceport above the 51st parallel north in the Amur Oblast, in the Russian Far East. It is intended to reduce Russia's dependency on the Baikonur Cosmodrome in Kazakhstan. The first launch took place on 28 April 2016 at 02:01 UTC.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg",
            "timezone_name": "Asia/Yakutsk",
            "total_launch_count": 19,
            "total_landing_count": 0
        },
        "country_code": "RUS",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg",
        "total_launch_count": 18,
        "orbital_launch_attempt_count": 18
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Пуск РН «Союз-2.1а» с КА «Канопус-В» №5 и 6",
            "description": "27 декабря 2018 года, в 5:07 мск со стартового комплекса космодрома Восточный осуществлен пуск ракеты-носителя «Союз-2.1а» с разгонным блоком «Фрегат» и косм...",
            "feature_image": "https://i.ytimg.com/vi/-MlQD-HWy6M/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=-MlQD-HWy6M",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Прямая трансляция пуска РКН \"Союз-2.1а\" с КА \"Канопус\" №5 и 6. Kanopus 5&6 launch. Live.",
            "description": "Место: космодром Восточный. Время начала комментирования трансляции: 27.12.2018 г., 4:00 (МСК). Время пуска: 5:07 (МСК) 27 декабря 2018 г. Комментировать тра...",
            "feature_image": "https://i.ytimg.com/vi/hwGaOllKVcA/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=hwGaOllKVcA",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20190726062341.png",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5819,
    "location_launch_attempt_count": 4,
    "pad_launch_attempt_count": 4,
    "agency_launch_attempt_count": 279,
    "orbital_launch_attempt_count_year": 113,
    "location_launch_attempt_count_year": 2,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 9,
    "pad_turnaround": "P329D",
    "mission_patches": [],
    "type": "detailed"
}