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/831731f3-ac79-4773-a05b-42f3861db726/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "831731f3-ac79-4773-a05b-42f3861db726",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/831731f3-ac79-4773-a05b-42f3861db726/?format=api",
    "slug": "ariane-5-eca-directv-14-gsat-16",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Ariane 5 ECA | DirecTV-14 & GSAT-16",
    "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:01:25Z",
    "updates": [],
    "net": "2014-12-06T20:40:07Z",
    "net_precision": null,
    "window_end": "2014-12-06T20:40:07Z",
    "window_start": "2014-12-06T20:40:07Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": null,
    "hashtag": null,
    "launch_service_provider": {
        "id": 115,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
        "name": "Arianespace",
        "featured": true,
        "type": "Commercial",
        "country_code": "FRA",
        "abbrev": "ASA",
        "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
        "administrator": "CEO: David Cavaillolès",
        "founding_year": "1980",
        "launchers": "Ariane | Vega",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 323,
        "consecutive_successful_launches": 11,
        "successful_launches": 308,
        "failed_launches": 15,
        "pending_launches": 34,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.arianespace.com",
        "wiki_url": "https://en.wikipedia.org/wiki/Arianespace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg"
    },
    "rocket": {
        "id": 1018,
        "configuration": {
            "id": 20,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/20/?format=api",
            "name": "Ariane 5 ECA",
            "active": false,
            "reusable": false,
            "description": "Ariane 5 is a heavy-lift launch vehicle, part of the Ariane rocket family.",
            "family": "Ariane",
            "full_name": "Ariane 5 ECA",
            "manufacturer": {
                "id": 1044,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1044/?format=api",
                "name": "ArianeGroup",
                "featured": false,
                "type": "Commercial",
                "country_code": "FRA",
                "abbrev": "AG",
                "description": "ArianeGroup (formerly Airbus Safran Launchers) is an aerospace company based in France. A joint venture between Airbus and Safran, the company was founded in 2015 and is headquartered in Issy-les-Moulineaux. It consists of three core arms: aerospace, defence and security.",
                "administrator": "CEO: Martin Sion",
                "founding_year": "2015",
                "launchers": "Ariane",
                "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": "https://www.ariane.group/",
                "wiki_url": "https://en.wikipedia.org/wiki/ArianeGroup",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg"
            },
            "program": [],
            "variant": "ECA",
            "alias": "",
            "min_stage": 0,
            "max_stage": 2,
            "length": 57.7,
            "diameter": 5.4,
            "maiden_flight": "2002-12-11",
            "launch_cost": null,
            "launch_mass": 780,
            "leo_capacity": null,
            "gto_capacity": 10500,
            "to_thrust": 11400,
            "apogee": 40000,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Ariane_5",
            "total_launch_count": 73,
            "consecutive_successful_launches": 8,
            "successful_launches": 71,
            "failed_launches": 2,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 890,
        "name": "DirecTV-14 & GSAT-16",
        "description": "DirecTV 14 is the first satellite oferring Ultra-HD 4k television services using Reverse DBS. It operates at 99 degrees West delivering service to the US and Puerto Rico. GSAT-16 is an Indian communication satellite to enhance satellite based telecommunication, television and VSAT services in India.",
        "launch_designator": null,
        "type": "Communications",
        "orbit": {
            "id": 2,
            "name": "Geostationary Transfer Orbit",
            "abbrev": "GTO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 77,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/77/?format=api",
        "agency_id": 115,
        "name": "Ariane Launch Area 3",
        "description": "ELA-3, is a launch pad and associated facilities at the Centre Spatial Guyanais in French Guiana. ELA-3 was operated by Arianespace as part of the expendable launch system for Ariane 5 launch vehicles.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/ELA-3",
        "map_url": "https://www.google.com/maps?q=5.239,-52.768",
        "latitude": "5.239",
        "longitude": "-52.768",
        "location": {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "timezone_name": "America/Cayenne",
            "total_launch_count": 329,
            "total_landing_count": 0
        },
        "country_code": "GUF",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_77_20200803143458.jpg",
        "total_launch_count": 118,
        "orbital_launch_attempt_count": 118
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Flight VA221 – DIRECTV-14 / GSAT-16 | Ariane 5 Launch | Arianespace",
            "description": "The sixth Ariane 5 launch of 2014 reflects the long-term relationship of mutual trust that Arianespace has established with the world's leading space telecom operators\n\nArianespace has successfully la...",
            "feature_image": "https://i.ytimg.com/vi/cUODlkIOroc/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=cUODlkIOroc",
            "type": null,
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2014-12-07T09:14:56Z",
            "end_time": "2014-12-07T10:26:59Z"
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5430,
    "location_launch_attempt_count": 242,
    "pad_launch_attempt_count": 77,
    "agency_launch_attempt_count": 227,
    "orbital_launch_attempt_count_year": 81,
    "location_launch_attempt_count_year": 10,
    "pad_launch_attempt_count_year": 6,
    "agency_launch_attempt_count_year": 10,
    "pad_turnaround": "P50DT22H56M15S",
    "mission_patches": [],
    "type": "detailed"
}