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/69f95edd-9075-4176-a9a1-103b7863d5e6/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "69f95edd-9075-4176-a9a1-103b7863d5e6",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/69f95edd-9075-4176-a9a1-103b7863d5e6/?format=api",
    "slug": "nuri-flight-test-2",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Nuri | Flight Test 2",
    "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-14T04:30:54Z",
    "updates": [
        {
            "id": 1931,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Successful launch confirmed.",
            "info_url": "https://www.youtube.com/watch?v=rmk9_IRlglI",
            "created_by": "Nosu",
            "created_on": "2022-06-21T08:09:31Z"
        },
        {
            "id": 1930,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Liftoff",
            "info_url": "https://www.youtube.com/watch?v=vdDe-p0hBuU",
            "created_by": "Nosu",
            "created_on": "2022-06-21T07:00:07Z"
        },
        {
            "id": 1929,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "English webcast live",
            "info_url": "https://www.youtube.com/watch?v=rmk9_IRlglI",
            "created_by": "Nosu",
            "created_on": "2022-06-21T06:40:41Z"
        },
        {
            "id": 1912,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for June 21",
            "info_url": "https://twitter.com/kari2030/status/1537757264479604737?s=21&t=IGjhipZ8DBkScgqhqnXBYw",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-17T11:47:58Z"
        },
        {
            "id": 1903,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Scrubbed due to LOX tank sensor problem; requires roll-back",
            "info_url": "https://twitter.com/arrow_cf/status/1536987612149186560?s=21&t=NNNkm0M4uW1CefYUfDh6MQ",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-15T09:01:33Z"
        },
        {
            "id": 1862,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Moving to June 16 due to weather",
            "info_url": "https://t.co/GU58ama1NF",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-13T23:47:22Z"
        },
        {
            "id": 1733,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Refined launch window",
            "info_url": "https://twitter.com/YonhapNews/status/1529326413396180993",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-05-25T05:47:37Z"
        },
        {
            "id": 1555,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Updated launch window.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=45923.msg2358535#msg2358535",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-04-09T09:45:11Z"
        },
        {
            "id": 1323,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch",
            "info_url": "https://twitter.com/kari2030/status/1497100491737923584",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-02-25T09:07:32Z"
        }
    ],
    "net": "2022-06-21T07:00:00Z",
    "net_precision": null,
    "window_end": "2022-06-21T08:00:00Z",
    "window_start": "2022-06-21T06:00:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 41,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api",
        "name": "Korea Aerospace Research Institute",
        "featured": false,
        "type": "Government",
        "country_code": "KOR",
        "abbrev": "KARI",
        "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.",
        "administrator": "Administrator: Lee Sang-Ryool",
        "founding_year": "1989",
        "launchers": "Nuri",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 7,
        "consecutive_successful_launches": 2,
        "successful_launches": 4,
        "failed_launches": 3,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.kari.kr/",
        "wiki_url": "http://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg"
    },
    "rocket": {
        "id": 74,
        "configuration": {
            "id": 117,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/117/?format=api",
            "name": "Nuri",
            "active": true,
            "reusable": false,
            "description": "Nuri, also known as KSLV-II, is South Korea's second carrier rocket and the successor to KSLV-1.",
            "family": "KSLV",
            "full_name": "KSLV-2 Nuri",
            "manufacturer": {
                "id": 41,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api",
                "name": "Korea Aerospace Research Institute",
                "featured": false,
                "type": "Government",
                "country_code": "KOR",
                "abbrev": "KARI",
                "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.",
                "administrator": "Administrator: Lee Sang-Ryool",
                "founding_year": "1989",
                "launchers": "Nuri",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 7,
                "consecutive_successful_launches": 2,
                "successful_launches": 4,
                "failed_launches": 3,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.kari.kr/",
                "wiki_url": "http://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png",
                "image_url": null,
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg"
            },
            "program": [],
            "variant": "2",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 47.2,
            "diameter": 3.5,
            "maiden_flight": "2021-10-21",
            "launch_cost": null,
            "launch_mass": 200,
            "leo_capacity": 2600,
            "gto_capacity": null,
            "to_thrust": 2612,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_on_the_lau_image_20240307163812.jpeg",
            "info_url": "https://www.kari.re.kr/eng/sub03_03_01.do",
            "wiki_url": "https://en.wikipedia.org/wiki/KSLV-2",
            "total_launch_count": 3,
            "consecutive_successful_launches": 2,
            "successful_launches": 2,
            "failed_launches": 1,
            "pending_launches": 1,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 5958,
        "name": "Flight Test 2",
        "description": "Second flight of the KSLV-II \"Nuri\" launch vehicle, carrying a dummy satellite Payload of 1500 kg to sun-synchronous orbit.\r\n\r\nThe mission will in addition launch the performance verification satellite (PVSAT) and four Cubesats:\r\n- CubeSat (6U) STEP Cube Lab-II\r\n- CubeSat (3U) SNUGLITE-II\r\n- CubeSat (3U) MIMAN\r\n- CubeSat (3U) RANDEV",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 192,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/192/?format=api",
        "agency_id": 41,
        "name": "LC-2",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Naro_Space_Center",
        "map_url": "https://www.google.com/maps?q=34.431867,127.535069",
        "latitude": "34.431867",
        "longitude": "127.535069",
        "location": {
            "id": 9,
            "url": "https://ll.thespacedevs.com/2.2.0/location/9/?format=api",
            "name": "Naro Space Center, South Korea",
            "country_code": "KOR",
            "description": "The Naro Space Center is a South Korean spaceport in South Jeolla's Goheung County, operated by the state-run Korea Aerospace Research Institute.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_9_20200803142441.jpg",
            "timezone_name": "Asia/Seoul",
            "total_launch_count": 7,
            "total_landing_count": 0
        },
        "country_code": "KOR",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_lc-2_20210812070305.jpg",
        "total_launch_count": 4,
        "orbital_launch_attempt_count": 3
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 9,
            "source": null,
            "publisher": null,
            "title": "[LIVE] SECOND LAUNCH OF NURI | ARIRANG NEWS",
            "description": ".  ▪ SECOND LAUNCH OF NUR▪ 누리호 2차발사 특집 생중계#SouthKorea #space_rocket #Nuri 📣 Arirang News(Facebook) : https://www.facebook.com/arirangtvnews📣 Arirang News(T...",
            "feature_image": "https://i.ytimg.com/vi/rmk9_IRlglI/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=rmk9_IRlglI",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "[공식] 누리호 2차 발사 생중계",
            "description": "우주강국을 향한누리호의 두 번째 도전!　나로우주센터에서 발사 현장을 생생하게 전달해 드립니다.",
            "feature_image": "https://i.ytimg.com/vi/vdDe-p0hBuU/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=vdDe-p0hBuU",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_on_the_lau_image_20240307163812.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6250,
    "location_launch_attempt_count": 6,
    "pad_launch_attempt_count": 3,
    "agency_launch_attempt_count": 6,
    "orbital_launch_attempt_count_year": 68,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P242DT23H",
    "mission_patches": [],
    "type": "detailed"
}