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/e6d98870-9a89-4cca-bbd1-511eed4bf2ce/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "e6d98870-9a89-4cca-bbd1-511eed4bf2ce",
    "url": "https://lldev.thespacedevs.com/2.2.0/launch/e6d98870-9a89-4cca-bbd1-511eed4bf2ce/?format=api",
    "slug": "pslv-xl-eos-09-risat-1b",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "PSLV-XL | EOS-09 (RISAT-1B)",
    "status": {
        "id": 4,
        "name": "Launch Failure",
        "abbrev": "Failure",
        "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate."
    },
    "last_updated": "2025-05-18T00:48:03Z",
    "updates": [
        {
            "id": 11023,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Official Webcast by ISRO Official has started",
            "info_url": "https://www.youtube.com/watch?v=y63x4kjvAc0",
            "created_by": "LL2",
            "created_on": "2025-05-18T00:01:00Z"
        },
        {
            "id": 10860,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET May 19.",
            "info_url": "https://www.deccanchronicle.com/southern-states/andhra-pradesh/isro-to-launch-eos-09-satellite-on-board-pslv-c61-on-may-19-1875644",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-04-29T13:17:00Z"
        },
        {
            "id": 11024,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Liftoff.",
            "info_url": "https://www.youtube.com/watch?v=y63x4kjvAc0",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-05-18T00:29:00Z"
        },
        {
            "id": 11025,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Launch failure.",
            "info_url": "https://www.youtube.com/watch?v=y63x4kjvAc0",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-05-18T00:48:00Z"
        },
        {
            "id": 10875,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch window, NET May 18.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=45538.msg2682949#msg2682949",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-05-01T13:57:00Z"
        },
        {
            "id": 10753,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch.",
            "info_url": "https://x.com/TitaniumSV5/status/1913248212325933506",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-04-18T16:07:00Z"
        },
        {
            "id": 10924,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch time.",
            "info_url": "https://www.eenadu.net/telugu-news/telangana/pslv-c61-launch-on-18th/1802/125082608",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-05-08T13:24:00Z"
        },
        {
            "id": 10998,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Adjusted T-0.",
            "info_url": "https://x.com/isro/status/1922964686502494391",
            "created_by": "Cosmic_Penguin",
            "created_on": "2025-05-15T11:05:00Z"
        }
    ],
    "net": "2025-05-18T00:29:00Z",
    "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "window_end": "2025-05-18T04:00:00Z",
    "window_start": "2025-05-18T00:00:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "3rd stage failure during burn.",
    "hashtag": null,
    "launch_service_provider": {
        "id": 31,
        "url": "https://lldev.thespacedevs.com/2.2.0/agencies/31/?format=api",
        "name": "Indian Space Research Organization",
        "featured": true,
        "type": "Government",
        "country_code": "IND",
        "abbrev": "ISRO",
        "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
        "administrator": "Chairman: V. Narayanan",
        "founding_year": "1969",
        "launchers": "PSLV | GSLV",
        "spacecraft": "Gaganyaan",
        "launch_library_url": null,
        "total_launch_count": 95,
        "consecutive_successful_launches": 0,
        "successful_launches": 81,
        "failed_launches": 14,
        "pending_launches": 18,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.isro.gov.in/",
        "wiki_url": "https://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
    },
    "rocket": {
        "id": 8592,
        "configuration": {
            "id": 38,
            "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/38/?format=api",
            "name": "PSLV-XL",
            "active": true,
            "reusable": false,
            "description": "PSLV-XL is the upgraded version of Polar Satellite Launch Vehicle in its standard configuration boosted by more powerful, stretched strap-on boosters with 12 tonne propellant load. Weighing 320t at lift-off, the vehicle uses larger strap-on motors (PSOM-XL or S12) to achieve higher payload capability. On 29 December 2005, ISRO successfully tested the improved version of strap-on booster for the PSLV. The first use of PSLV-XL was the launch of Chandrayaan-1 by PSLV C11. The payload capability for this variant is 1,800 kg to SSO.",
            "family": "PSLV",
            "full_name": "PSLV XL",
            "manufacturer": {
                "id": 31,
                "url": "https://lldev.thespacedevs.com/2.2.0/agencies/31/?format=api",
                "name": "Indian Space Research Organization",
                "featured": true,
                "type": "Government",
                "country_code": "IND",
                "abbrev": "ISRO",
                "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
                "administrator": "Chairman: V. Narayanan",
                "founding_year": "1969",
                "launchers": "PSLV | GSLV",
                "spacecraft": "Gaganyaan",
                "launch_library_url": null,
                "total_launch_count": 95,
                "consecutive_successful_launches": 0,
                "successful_launches": 81,
                "failed_launches": 14,
                "pending_launches": 18,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.isro.gov.in/",
                "wiki_url": "https://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
            },
            "program": [],
            "variant": "XL",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 44.0,
            "diameter": 2.8,
            "maiden_flight": "2008-10-22",
            "launch_cost": null,
            "launch_mass": 320,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20190224012254.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Polar_Satellite_Launch_Vehicle",
            "total_launch_count": 27,
            "consecutive_successful_launches": 0,
            "successful_launches": 25,
            "failed_launches": 2,
            "pending_launches": 1,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 7184,
        "name": "EOS-09 (RISAT-1B)",
        "description": "RISAT-1B is the third in the series of radar imaging RISAT-1 satellites of ISRO using an active C-band SAR (Synthetic Aperture Radar), providing all-weather as well as the day-and-night SAR observation capability in applications such as agriculture, forestry, soil moisture, geology, sea ice, coastal monitoring, object identification, and flood monitoring, in addition to military surveillance.\r\n\r\nThe RISAT-1 series is developed, manufactured and integrated by ISRO. The 3-axis stabilized spacecraft bus consists of a hexagonal prism shape build around a central cylinder. Most of the spacecraft subsystems and the payload are integrated in the prism structure and the central cylinder. The solar panels and some subsystems are mounted on the cube-shaped section of the spacecraft.",
        "launch_designator": null,
        "type": "Government/Top Secret",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 50,
        "url": "https://lldev.thespacedevs.com/2.2.0/pad/50/?format=api",
        "agency_id": 31,
        "name": "Satish Dhawan Space Centre First Launch Pad",
        "description": "India has two launch pads at the site. The First Launch Pad, operational since 1993, is used for Polar Satellite Launch Vehicle, Small Satellite Launch Vehicle and formerly used by Geosynchronous Satellite Launch Vehicle.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_First_Launch_Pad",
        "map_url": "https://www.google.com/maps?q=13.733,80.235",
        "latitude": "13.733",
        "longitude": "80.235",
        "location": {
            "id": 14,
            "url": "https://lldev.thespacedevs.com/2.2.0/location/14/?format=api",
            "name": "Satish Dhawan Space Centre, India",
            "country_code": "IND",
            "description": "Satish Dhawan Space Centre – SDSC (formerly Sriharikota Range – SHAR),[1] is the primary spaceport of the Indian Space Research Organisation (ISRO), located in Sriharikota, Andhra Pradesh.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg",
            "timezone_name": "Asia/Kolkata",
            "total_launch_count": 99,
            "total_landing_count": 0
        },
        "country_code": "IND",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_50_20200803143457.jpg",
        "total_launch_count": 62,
        "orbital_launch_attempt_count": 61
    },
    "infoURLs": [
        {
            "priority": 10,
            "source": "www.isro.gov.in",
            "title": "PSLV-C61 / EOS-09 Mission",
            "description": "India is set to achieve a significant milestone with the 101st mission of its space programme. On 18 May 2025 at 05:59 AM IST, ISRO will launch EOS-09 aboard the PSLV-C61 from the First Launch Pad (FLP) at Satish Dhawan Space Centre, SHAR . The mission will place the Earth Observation Satellite into...",
            "feature_image": null,
            "url": "https://www.isro.gov.in/Mission_PSLV_C61_EOS_09.html",
            "type": {
                "id": 1,
                "name": "Official Page"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        },
        {
            "priority": 10,
            "source": "www.isro.gov.in",
            "title": "",
            "description": "",
            "feature_image": null,
            "url": "https://www.isro.gov.in/media_isro/pdf/PSLVC61/PSLV_C61_EOS_09_Brochure.pdf",
            "type": {
                "id": 2,
                "name": "Official Press Kit"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "ISRO Official",
            "title": "ISRO’s 101st Launch | PSLV-C61 / EOS-09 | 18 May 2025",
            "description": "ISRO’s 101st launch mission with PSLV-C61 on 18 May 2025 at 5:59 AM IST carries EOS-09, a 1696 kg Earth observation satellite, into a Sun-Synchronous Polar Orbit.",
            "feature_image": "https://i.ytimg.com/vi/y63x4kjvAc0/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=y63x4kjvAc0",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2025-05-18T00:00:37Z",
            "end_time": "2025-05-18T00:46:16Z"
        }
    ],
    "webcast_live": false,
    "timeline": [
        {
            "type": {
                "id": 148,
                "abbrev": "RCT Ignition",
                "description": "Ignition of Roll Control Thrusters"
            },
            "relative_time": "-PT3S"
        },
        {
            "type": {
                "id": 9,
                "abbrev": "Ignition",
                "description": "Start of the engine ignition sequence"
            },
            "relative_time": "P0D"
        },
        {
            "type": {
                "id": 129,
                "abbrev": "Booster Ignition",
                "description": "Ignition of the solid rocket boosters."
            },
            "relative_time": "PT0.42S"
        },
        {
            "type": {
                "id": 129,
                "abbrev": "Booster Ignition",
                "description": "Ignition of the solid rocket boosters."
            },
            "relative_time": "PT0.62S"
        },
        {
            "type": {
                "id": 129,
                "abbrev": "Booster Ignition",
                "description": "Ignition of the solid rocket boosters."
            },
            "relative_time": "PT25S"
        },
        {
            "type": {
                "id": 100,
                "abbrev": "Booster Separation",
                "description": "The side boosters are separated from the launcher."
            },
            "relative_time": "PT1M9.9S"
        },
        {
            "type": {
                "id": 100,
                "abbrev": "Booster Separation",
                "description": "The side boosters are separated from the launcher."
            },
            "relative_time": "PT1M10.1S"
        },
        {
            "type": {
                "id": 100,
                "abbrev": "Booster Separation",
                "description": "The side boosters are separated from the launcher."
            },
            "relative_time": "PT1M32S"
        },
        {
            "type": {
                "id": 13,
                "abbrev": "Stage 2 Separation",
                "description": "Separation of the second stage from the first"
            },
            "relative_time": "PT1M51.64S"
        },
        {
            "type": {
                "id": 31,
                "abbrev": "SES",
                "description": "Start of the second engine"
            },
            "relative_time": "PT1M51.84S"
        },
        {
            "type": {
                "id": 15,
                "abbrev": "Fairing Separation",
                "description": "Separation of the payload fairing"
            },
            "relative_time": "PT2M32.78S"
        },
        {
            "type": {
                "id": 149,
                "abbrev": "CLG Start",
                "description": "Start of Closed Loop Guidance"
            },
            "relative_time": "PT2M37.78S"
        },
        {
            "type": {
                "id": 74,
                "abbrev": "Stage 3 Separation",
                "description": "Separation of the third stage from the second"
            },
            "relative_time": "PT4M24.34S"
        },
        {
            "type": {
                "id": 75,
                "abbrev": "Stage 3 Ignition",
                "description": "Third stage engine ignites."
            },
            "relative_time": "PT4M25.54S"
        },
        {
            "type": {
                "id": 30,
                "abbrev": "Kick Stage Separation",
                "description": "Separation of the kick stage from the previous stage"
            },
            "relative_time": "PT8M13S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT8M23.4S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT16M52.24S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT17M39.24S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT37M11.52S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT45M56.78S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT1H22M32.52S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT1H31M2.04S"
        },
        {
            "type": {
                "id": 150,
                "abbrev": "MON Passivation",
                "description": "Start of Mixed Oxides of Nitrogen passivation"
            },
            "relative_time": "PT1H32M52.04S"
        },
        {
            "type": {
                "id": 151,
                "abbrev": "MMH Passivation",
                "description": "Start of Monomethylhydrazine passivation"
            },
            "relative_time": "PT1H41M52.04S"
        }
    ],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20190224012254.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6957,
    "location_launch_attempt_count": 99,
    "pad_launch_attempt_count": 62,
    "agency_launch_attempt_count": 95,
    "orbital_launch_attempt_count_year": 108,
    "location_launch_attempt_count_year": 2,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 2,
    "pad_turnaround": "P138DT7H58M45S",
    "mission_patches": [],
    "type": "detailed"
}