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/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "a8c191e1-b231-4b2e-aefd-5e8ad55c7a82",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api",
    "launch_library_id": null,
    "slug": "miura-5-maiden-flight",
    "name": "Miura 5 | Maiden Flight",
    "status": {
        "id": 2,
        "name": "TBD"
    },
    "net": "2025-12-31T00:00:00Z",
    "window_end": "2025-12-31T00:00:00Z",
    "window_start": "2025-12-31T00:00:00Z",
    "inhold": false,
    "tbdtime": true,
    "tbddate": true,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 1051,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/1051/?format=api",
        "name": "Payload Aerospace S.L.",
        "featured": false,
        "type": "Commercial",
        "country_code": "ESP",
        "abbrev": "PLD Space",
        "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.",
        "administrator": "CEO: Raúl Torres",
        "founding_year": "2011",
        "launchers": "Miura 1 | Miura 5",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 1,
        "consecutive_successful_launches": 1,
        "successful_launches": 1,
        "failed_launches": 0,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.pldspace.com/en/",
        "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg"
    },
    "rocket": {
        "id": 8207,
        "configuration": {
            "id": 509,
            "launch_library_id": null,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/509/?format=api",
            "name": "Miura 5",
            "description": "MIURA 5 is a 2 stage launch vehicle powered by liquid oxygen and kerosene. The vehicle is designed,\r\nintegrated and operated by PLD Space, and its 1st stage is designed to be eventually recovered by parachuting into the sea.",
            "family": "Miura",
            "full_name": "Miura 5",
            "manufacturer": {
                "id": 1051,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/1051/?format=api",
                "name": "Payload Aerospace S.L.",
                "featured": false,
                "type": "Commercial",
                "country_code": "ESP",
                "abbrev": "PLD Space",
                "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.",
                "administrator": "CEO: Raúl Torres",
                "founding_year": "2011",
                "launchers": "Miura 1 | Miura 5",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 1,
                "consecutive_successful_launches": 1,
                "successful_launches": 1,
                "failed_launches": 0,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.pldspace.com/en/",
                "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png",
                "image_url": null,
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 2,
            "max_stage": 3,
            "length": 35.81,
            "diameter": 2.0,
            "maiden_flight": null,
            "launch_mass": null,
            "leo_capacity": 900,
            "gto_capacity": null,
            "to_thrust": 950,
            "apogee": null,
            "vehicle_range": null,
            "image_url": null,
            "info_url": "https://www.pldspace.com/en/miura-5",
            "wiki_url": "https://en.wikipedia.org/wiki/Miura_5",
            "total_launch_count": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 1
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6779,
        "launch_library_id": null,
        "name": "Maiden Flight",
        "description": "First flight of the Miura 5 launch vehicle.",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 125,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/125/?format=api",
        "agency_id": 115,
        "name": "Diamant Launch Area",
        "info_url": null,
        "wiki_url": null,
        "map_url": "https://www.google.com/maps?q=5.2222222,-52.7758051",
        "latitude": "5.2222222",
        "longitude": "-52.7758051",
        "location": {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "total_launch_count": 325,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg",
        "total_launch_count": 8
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": null,
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7113,
    "location_launch_attempt_count": 343,
    "pad_launch_attempt_count": 9,
    "agency_launch_attempt_count": 2,
    "orbital_launch_attempt_count_year": 264,
    "location_launch_attempt_count_year": 20,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1
}