API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch// 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'

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.0.0/launch/90232cff-15ff-4755-8a56-4ed544767665/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "90232cff-15ff-4755-8a56-4ed544767665",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/90232cff-15ff-4755-8a56-4ed544767665/?format=api",
    "launch_library_id": null,
    "slug": "pslv-xl-oceansat-3a",
    "name": "PSLV-XL | Oceansat-3A",
    "status": {
        "id": 2,
        "name": "TBD"
    },
    "net": "2025-11-30T00:00:00Z",
    "window_end": "2025-11-30T00:00:00Z",
    "window_start": "2025-11-30T00:00:00Z",
    "inhold": false,
    "tbdtime": true,
    "tbddate": true,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 31,
        "url": "https://ll.thespacedevs.com/2.0.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": 94,
        "consecutive_successful_launches": 16,
        "successful_launches": 81,
        "failed_launches": 13,
        "pending_launches": 17,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.isro.gov.in/",
        "wiki_url": "http://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": 8514,
        "configuration": {
            "id": 38,
            "launch_library_id": 38,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/38/?format=api",
            "name": "PSLV-XL",
            "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://ll.thespacedevs.com/2.0.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": 94,
                "consecutive_successful_launches": 16,
                "successful_launches": 81,
                "failed_launches": 13,
                "pending_launches": 17,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.isro.gov.in/",
                "wiki_url": "http://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_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": 26,
            "consecutive_successful_launches": 8,
            "successful_launches": 25,
            "failed_launches": 1,
            "pending_launches": 1
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 7104,
        "launch_library_id": null,
        "name": "Oceansat-3A",
        "description": "Oceansat-3A is a part of ISRO's Oceansat program. Its main purpose is ocean observation, which includes gathering ocean color data, sea surface temperature measurements and wind vector data.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 50,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/50/?format=api",
        "agency_id": 31,
        "name": "Satish Dhawan Space Centre First Launch Pad",
        "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://ll.thespacedevs.com/2.0.0/location/14/?format=api",
            "name": "Satish Dhawan Space Centre, India",
            "country_code": "IND",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg",
            "total_launch_count": 98,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_50_20200803143457.jpg",
        "total_launch_count": 61
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20190224012254.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7002,
    "location_launch_attempt_count": 102,
    "pad_launch_attempt_count": 63,
    "agency_launch_attempt_count": 98,
    "orbital_launch_attempt_count_year": 153,
    "location_launch_attempt_count_year": 5,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 5
}