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/27fd5d5a-6935-4697-98b4-b409f029e2f0/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "27fd5d5a-6935-4697-98b4-b409f029e2f0",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/27fd5d5a-6935-4697-98b4-b409f029e2f0/?format=api",
    "slug": "proton-m-mlm-nauka",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Proton-M | MLM Nauka",
    "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-06-14T03:35:01Z",
    "updates": [
        {
            "id": 671,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
            "comment": "Module is healthy and in planned orbit.",
            "info_url": "https://twitter.com/roscosmos/status/1417865017920311300",
            "created_by": "spacevogel",
            "created_on": "2021-07-21T15:15:40Z"
        },
        {
            "id": 79,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "",
            "info_url": "https://twitter.com/RussianSpaceWeb/status/1334126498144530434",
            "created_by": "Nosu",
            "created_on": "2020-12-02T14:05:12Z"
        },
        {
            "id": 649,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
            "comment": "Corrected the T-0",
            "info_url": "https://www.roscosmos.ru/31746/",
            "created_by": "spacevogel",
            "created_on": "2021-07-08T12:00:14Z"
        },
        {
            "id": 648,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
            "comment": "New date confirmed by Roscosmos",
            "info_url": "https://twitter.com/roscosmos/status/1413002375669891072",
            "created_by": "spacevogel",
            "created_on": "2021-07-08T05:48:36Z"
        },
        {
            "id": 644,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Launch postponed to NET July 21 due to thermal blankets missing from MLM Nauka's star trackers.",
            "info_url": "https://ria.ru/20210705/mks-1739941330.html",
            "created_by": "Nosu",
            "created_on": "2021-07-05T15:52:28Z"
        },
        {
            "id": 542,
            "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "The MLM Nauka module has successfully completed its testing phase. Launch currently targeted for July 15.",
            "info_url": "https://twitter.com/Rogozin/status/1397237459176599565?s=20",
            "created_by": "Nosu",
            "created_on": "2021-05-26T08:01:21Z"
        }
    ],
    "net": "2021-07-21T14:58:25Z",
    "net_precision": null,
    "window_end": "2021-07-21T14:58:25Z",
    "window_start": "2021-07-21T14:58:25Z",
    "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": 194,
        "consecutive_successful_launches": 5,
        "successful_launches": 179,
        "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png",
        "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg",
        "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg"
    },
    "rocket": {
        "id": 124,
        "configuration": {
            "id": 152,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/152/?format=api",
            "name": "Proton-M",
            "active": true,
            "reusable": false,
            "description": "Proton-M is a three stage Russian heavy lift launch vehicle derived from the Soviet Proton launch vehicle.\r\n\r\nImage Credit: Alex Lane",
            "family": "Proton / UR-500",
            "full_name": "Proton-M",
            "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": 194,
                "consecutive_successful_launches": 5,
                "successful_launches": 179,
                "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png",
                "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg",
                "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 58.2,
            "diameter": 7.4,
            "maiden_flight": "2001-04-07",
            "launch_cost": "65000000",
            "launch_mass": 705,
            "leo_capacity": 23000,
            "gto_capacity": 6920,
            "to_thrust": 10532,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/proton-m_image_20201205235758.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Proton-M",
            "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": {
        "id": 656,
        "name": "MLM Nauka",
        "description": "Nauka (which means \"Science\" in Russian), also known as Multipurpose Laboratory Module (MLM), is a new module of the russian segment of the ISS. It will dock at Zvezda's nadir port, replacing the Pirs module occupying it since September 2001. The Nauka module is designed to be used for experiments, docking and cargo as well as serve as a crew work and rest area. It is equipped with full guidance and navigation control including engines and an attitude control system that can be used as a backup by the ISS. The Nauka module also brings the European Robotic Arm, for which a spare elbow joint was already launched in 2010, to the orbital laboratory.",
        "launch_designator": null,
        "type": "Human Exploration",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 15,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/15/?format=api",
        "agency_id": null,
        "name": "200/39 (200L)",
        "description": null,
        "info_url": null,
        "wiki_url": "",
        "map_url": "https://www.google.com/maps?q=46.039984,63.032093",
        "latitude": "46.039984",
        "longitude": "63.032093",
        "location": {
            "id": 15,
            "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api",
            "name": "Baikonur Cosmodrome, Republic of Kazakhstan",
            "country_code": "KAZ",
            "description": "",
            "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_15_20200803142517.jpg",
            "timezone_name": "Asia/Qyzylorda",
            "total_launch_count": 1548,
            "total_landing_count": 0
        },
        "country_code": "KAZ",
        "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_15_20200803143530.jpg",
        "total_launch_count": 167,
        "orbital_launch_attempt_count": 167
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 8,
            "source": null,
            "publisher": null,
            "title": "Пуск РН \"Протон-М\" с МЛМ \"Наука\". Видео со всех камер",
            "description": "С пусковой установки № 39 стартовой площадки № 200 космодрома Байконур 21 июля 2021 года в 17:58:24,938 по московскому времени состоялся пуск ракеты-носителя...",
            "feature_image": "https://i.ytimg.com/vi/NikeEjmq5uc/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=NikeEjmq5uc&pp=sAQA",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 8,
            "source": null,
            "publisher": null,
            "title": "«Наука» на орбите!",
            "description": "С пусковой установки № 39 стартовой площадки № 200 космодрома Байконур 21 июля 2021 года в 17:58:24,938 по московскому времени состоялся пуск ракеты-носителя...",
            "feature_image": "https://i.ytimg.com/vi/9-xBhU7ZI7s/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=9-xBhU7ZI7s",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 9,
            "source": null,
            "publisher": null,
            "title": "Пуск ракеты-носителя «Протон-М» с модулем «Наука»",
            "description": "21 июля 2021 года в 17:58:21 по московскому времени с космодрома Байконур выполнен пуск ракеты-носителя «Протон-М» с новым лабораторным модулем «Наука». Его ...",
            "feature_image": "https://i.ytimg.com/vi/t-V-hgTPZBs/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=t-V-hgTPZBs",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "ERA launch replay",
            "description": "The European Robotic Arm (ERA) is on its way to the International Space Station after being launched on a Proton rocket from the Baikonur Cosmodrome, in Kaza...",
            "feature_image": "https://i.ytimg.com/vi/F1o7gc8K7Z0/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=F1o7gc8K7Z0",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/proton-m_image_20201205235758.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6095,
    "location_launch_attempt_count": 1521,
    "pad_launch_attempt_count": 165,
    "agency_launch_attempt_count": 187,
    "orbital_launch_attempt_count_year": 69,
    "location_launch_attempt_count_year": 6,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P355DT17H33M6S",
    "mission_patches": [
        {
            "id": 68,
            "name": "Nauka Module Patch",
            "priority": 10,
            "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/mission_patch_images/nauka2520modul_mission_patch_20210713084702.png",
            "agency": {
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "type": "Government"
            }
        }
    ],
    "type": "detailed"
}