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/2277b184-5a07-4a71-90ce-367f41420eaa/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "2277b184-5a07-4a71-90ce-367f41420eaa",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/2277b184-5a07-4a71-90ce-367f41420eaa/?format=api",
    "slug": "soyuz-21bfregat-m-luna-25",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Soyuz 2.1b/Fregat-M | Luna 25",
    "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-03-05T18:31:10Z",
    "updates": [
        {
            "id": 4843,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Successful deployment of Luna 25 into the trans-lunar trajectory",
            "info_url": "https://tass.com/russia/1659069",
            "created_by": "SwGustav",
            "created_on": "2023-08-11T01:25:57Z"
        },
        {
            "id": 4842,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Liftoff",
            "info_url": "https://www.youtube.com/watch?v=cgi2pIFrnW4",
            "created_by": "SwGustav",
            "created_on": "2023-08-10T23:11:26Z"
        },
        {
            "id": 4841,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Livestream has started",
            "info_url": "https://www.youtube.com/watch?v=cgi2pIFrnW4",
            "created_by": "LL2",
            "created_on": "2023-08-10T22:00:35Z"
        },
        {
            "id": 4790,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "GO for launch.",
            "info_url": "https://www.roscosmos.ru/media/files/2023/July/luna-25-sovmestniy.pdf",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-08-07T12:45:49Z"
        },
        {
            "id": 4659,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Tweaked T-0.",
            "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?topic=16415.2200",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-07-24T02:07:59Z"
        },
        {
            "id": 4283,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET August 11.",
            "info_url": "https://tass.ru/kosmos/17932551",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-06-05T15:28:47Z"
        },
        {
            "id": 4230,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET August 2023.",
            "info_url": "https://t.me/roscosmos_gk/9640",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-05-30T17:52:47Z"
        },
        {
            "id": 4027,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch time.",
            "info_url": "https://t.me/roscosmos_press/1154",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-05-12T14:29:25Z"
        },
        {
            "id": 3376,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET July 13",
            "info_url": "https://twitter.com/katlinegrey/status/1628781301477122049",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-02-23T16:10:44Z"
        },
        {
            "id": 2447,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Delayed to NET July 2023",
            "info_url": "https://twitter.com/RussianSpaceWeb/status/1572258343804145664",
            "created_by": "Jay",
            "created_on": "2022-09-20T16:37:55Z"
        },
        {
            "id": 2343,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET 2023",
            "info_url": "https://twitter.com/katlinegrey/status/1567454797783072771?t=Q6Y9mS_gUdPSPAiQgT_b0Q&s=19",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-09-07T10:21:12Z"
        },
        {
            "id": 1210,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding T-0",
            "info_url": "https://tass.com/science/1393447",
            "created_by": "Nosu",
            "created_on": "2022-01-27T13:02:28Z"
        },
        {
            "id": 4306,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Adding T-0.",
            "info_url": "https://t.me/taygaxtour28region/1243",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-06-08T09:30:20Z"
        }
    ],
    "net": "2023-08-10T23:10:57Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2023-08-10T23:10:57Z",
    "window_start": "2023-08-10T23:10:57Z",
    "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": 335,
        "consecutive_successful_launches": 59,
        "successful_launches": 324,
        "failed_launches": 11,
        "pending_launches": 5,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://en.roscosmos.ru/",
        "wiki_url": "https://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": 2703,
        "configuration": {
            "id": 134,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/134/?format=api",
            "name": "Soyuz 2.1b/Fregat-M",
            "active": true,
            "reusable": false,
            "description": "Soyuz-2, GRAU index 14A14, is the collective designation for the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit. The first-stage boosters and two core stages feature uprated engines with improved injection systems, compared to the previous versions of the Soyuz. Digital flight control and telemetry systems allow the rocket to be launched from a fixed launch platform, whereas the launch platforms for earlier Soyuz rockets had to be rotated as the rocket could not perform a roll to change its heading in flight.",
            "family": "Soyuz",
            "full_name": "Soyuz 2.1b 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": 4,
            "max_stage": 4,
            "length": 46.3,
            "diameter": 10.3,
            "maiden_flight": "2008-07-26",
            "launch_cost": "48500000",
            "launch_mass": 313,
            "leo_capacity": 8200,
            "gto_capacity": 3250,
            "to_thrust": 4150,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2",
            "total_launch_count": 33,
            "consecutive_successful_launches": 33,
            "successful_launches": 33,
            "failed_launches": 0,
            "pending_launches": 3,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6360,
        "name": "Luna 25",
        "description": "Luna 25 (ex-Luna-Glob) was a lunar lander mission by the Russian Federal Space Agency (Roscosmos) that crashed into the lunar surface after an anomalous orbital maneuver placed it on a collision trajectory towards the Moon. It was scheduled to land near the lunar south pole at the Boguslavsky crater to prove lunar landing technology. The mission carried 30 kg of scientific instruments, including a robotic arm for soil samples and possible drilling hardware. It was planned to remain active for at least one year on the lunar surface.",
        "launch_designator": null,
        "type": "Lunar Exploration",
        "orbit": {
            "id": 11,
            "name": "Lunar Orbit",
            "abbrev": "LO"
        },
        "agencies": [
            {
                "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": 335,
                "consecutive_successful_launches": 59,
                "successful_launches": 324,
                "failed_launches": 11,
                "pending_launches": 5,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://en.roscosmos.ru/",
                "wiki_url": "https://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"
            }
        ],
        "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": 20,
            "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": 19,
        "orbital_launch_attempt_count": 19
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "Роскосмос ТВ",
            "title": "Трансляция запуска автоматической станции «Луна-25»",
            "description": "11 августа в 02:10:57 мск с космодрома Восточный к естественному спутнику Земли отправилась «Луна-25». \n\nК этому событию мы вместе с RT подготовили специальный эфир: прямые включения с космодрома Вост...",
            "feature_image": "https://i.ytimg.com/vi/cgi2pIFrnW4/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=cgi2pIFrnW4",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 3,
                "name": "Russian",
                "code": "ru"
            },
            "start_time": "2023-08-10T22:00:12Z",
            "end_time": "2023-08-10T23:28:54Z"
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20230811103805.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6492,
    "location_launch_attempt_count": 15,
    "pad_launch_attempt_count": 15,
    "agency_launch_attempt_count": 314,
    "orbital_launch_attempt_count_year": 124,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 3,
    "agency_launch_attempt_count_year": 6,
    "pad_turnaround": "P44DT11H36M8S",
    "mission_patches": [],
    "type": "detailed"
}