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/3db5d8e4-2f56-47a6-bc14-0328c2f71aef/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "3db5d8e4-2f56-47a6-bc14-0328c2f71aef",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/3db5d8e4-2f56-47a6-bc14-0328c2f71aef/?format=api",
    "launch_library_id": null,
    "slug": "ariane-1-cat-1",
    "name": "Ariane 1 | CAT 1",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "1979-12-24T17:14:38Z",
    "window_end": "1979-12-24T17:14:38Z",
    "window_start": "1979-12-24T17:14:38Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 27,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/27/?format=api",
        "name": "European Space Agency",
        "featured": false,
        "type": "Multinational",
        "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN",
        "abbrev": "ESA",
        "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.",
        "administrator": "Director General: Josef Aschbacher",
        "founding_year": "1975",
        "launchers": "Ariane | Vega",
        "spacecraft": "Space Rider",
        "launch_library_url": null,
        "total_launch_count": 7,
        "consecutive_successful_launches": 5,
        "successful_launches": 6,
        "failed_launches": 1,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.esa.int/",
        "wiki_url": "http://en.wikipedia.org/wiki/European_Space_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png"
    },
    "rocket": {
        "id": 5134,
        "configuration": {
            "id": 219,
            "launch_library_id": null,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/219/?format=api",
            "name": "Ariane 1",
            "description": "Ariane 1 was the first rocket in the Ariane family of expendable launch systems. It was developed and operated by the European Space Agency (ESA), which had been formed in 1973, the same year that development of the launch had commenced.",
            "family": "Ariane",
            "full_name": "Ariane 1",
            "manufacturer": {
                "id": 1003,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/1003/?format=api",
                "name": "Aérospatiale",
                "featured": false,
                "type": "Government",
                "country_code": "FRA",
                "abbrev": "",
                "description": "Aérospatiale was a French state-owned aerospace manufacturer that built both civilian and military aircraft, rockets and satellites. It was originally known as Société nationale industrielle aérospatiale (SNIAS). Its head office was in the 16th arrondissement of Paris. The name was changed to Aérospatiale during 1970.",
                "administrator": null,
                "founding_year": "1970",
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/A%C3%A9rospatiale",
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "1",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 50.0,
            "diameter": 3.8,
            "maiden_flight": "1979-12-24",
            "launch_mass": 207,
            "leo_capacity": 1400,
            "gto_capacity": 1850,
            "to_thrust": 2771,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_1_in_fli_image_20240314094301.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Ariane_1",
            "total_launch_count": 11,
            "consecutive_successful_launches": 6,
            "successful_launches": 9,
            "failed_launches": 2,
            "pending_launches": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 3545,
        "launch_library_id": null,
        "name": "CAT 1",
        "description": "Vehicle evaluation payload for the Ariane 1 launch vehicle",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 0,
            "name": "Elliptical Orbit",
            "abbrev": "Elliptical"
        }
    },
    "pad": {
        "id": 34,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/34/?format=api",
        "agency_id": 115,
        "name": "Ariane Launch Area 1 (ELV)",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/ELA-1",
        "map_url": "https://www.google.com/maps?q=5.236,-52.775",
        "latitude": "5.236",
        "longitude": "-52.775",
        "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_34_20200803143527.jpg",
        "total_launch_count": 52
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_1_in_fli_image_20240314094301.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 2281,
    "location_launch_attempt_count": 10,
    "pad_launch_attempt_count": 2,
    "agency_launch_attempt_count": 1,
    "orbital_launch_attempt_count_year": 108,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1
}