GET

Launch Instance

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/6e7316e1-9e03-411d-a39f-c28e20e18a91/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "6e7316e1-9e03-411d-a39f-c28e20e18a91",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/6e7316e1-9e03-411d-a39f-c28e20e18a91/?format=api",
    "slug": "atlas-v-431-echostar-19-jupiter-2",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Atlas V 431 | Echostar 19 (Jupiter-2)",
    "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-14T17:42:26Z",
    "updates": [],
    "net": "2016-12-18T19:13:00Z",
    "net_precision": null,
    "window_end": "2016-12-18T20:27:00Z",
    "window_start": "2016-12-18T18:27:00Z",
    "probability": 70,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": null,
    "hashtag": null,
    "launch_service_provider": {
        "id": 124,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api",
        "name": "United Launch Alliance",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "ULA",
        "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
        "administrator": "CEO: Tory Bruno",
        "founding_year": "2006",
        "launchers": "Atlas | Delta IV | Vulcan",
        "spacecraft": "CST-100 Starliner",
        "launch_library_url": null,
        "total_launch_count": 165,
        "consecutive_successful_launches": 165,
        "successful_launches": 165,
        "failed_launches": 0,
        "pending_launches": 44,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.ulalaunch.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
    },
    "rocket": {
        "id": 1974,
        "configuration": {
            "id": 111,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/111/?format=api",
            "name": "Atlas V 431",
            "active": true,
            "reusable": false,
            "description": "Atlas V with 4m Fairing, 3 SRB, 1 Centaur upper stage engine.",
            "family": "Atlas",
            "full_name": "Atlas V 431",
            "manufacturer": {
                "id": 124,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api",
                "name": "United Launch Alliance",
                "featured": true,
                "type": "Commercial",
                "country_code": "USA",
                "abbrev": "ULA",
                "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
                "administrator": "CEO: Tory Bruno",
                "founding_year": "2006",
                "launchers": "Atlas | Delta IV | Vulcan",
                "spacecraft": "CST-100 Starliner",
                "launch_library_url": null,
                "total_launch_count": 165,
                "consecutive_successful_launches": 165,
                "successful_launches": 165,
                "failed_launches": 0,
                "pending_launches": 44,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.ulalaunch.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
            },
            "program": [],
            "variant": "431",
            "alias": "",
            "min_stage": 0,
            "max_stage": 2,
            "length": 59.1,
            "diameter": 3.8,
            "maiden_flight": "2005-03-11",
            "launch_cost": "130000000",
            "launch_mass": 479,
            "leo_capacity": 15260,
            "gto_capacity": 7700,
            "to_thrust": null,
            "apogee": 40000,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520431_image_20190222031015.jpeg",
            "info_url": null,
            "wiki_url": null,
            "total_launch_count": 3,
            "consecutive_successful_launches": 3,
            "successful_launches": 3,
            "failed_launches": 0,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 286,
        "name": "Echostar 19 (Jupiter-2)",
        "description": "Echostar-19, also known as Jupiter-2, is a world’s highest capacity broadband   satellite that will help meet the growing demand for HughesNet high-speed satellite internet service in North America. The satellite is designed to provide service for 15 years or more.",
        "launch_designator": null,
        "type": "Communications",
        "orbit": {
            "id": 2,
            "name": "Geostationary Transfer Orbit",
            "abbrev": "GTO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 29,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api",
        "agency_id": null,
        "name": "Space Launch Complex 41",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41",
        "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644",
        "latitude": "28.58341025",
        "longitude": "-80.58303644",
        "location": {
            "id": 12,
            "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api",
            "name": "Cape Canaveral SFS, FL, USA",
            "country_code": "USA",
            "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
            "timezone_name": "America/New_York",
            "total_launch_count": 1023,
            "total_landing_count": 64
        },
        "country_code": "USA",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg",
        "total_launch_count": 115,
        "orbital_launch_attempt_count": 115
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Atlas V EchoStar XIX Live Launch Broadcast",
            "description": "ULA's live launch broadcast of the Atlas V rocket launching the EchoStar XIX satellite.",
            "feature_image": "https://i.ytimg.com/vi/2pxYlm5z45I/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=2pxYlm5z45I",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Atlas V EchoStar XIX Launch Highlights",
            "description": "A United Launch Alliance Atlas V rocket carrying the EchoStar XIX satellite lifts off from Space Launch Complex-41.",
            "feature_image": "https://i.ytimg.com/vi/XNrmkLnpsUo/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=XNrmkLnpsUo",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520431_image_20190222031015.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5611,
    "location_launch_attempt_count": 754,
    "pad_launch_attempt_count": 84,
    "agency_launch_attempt_count": 116,
    "orbital_launch_attempt_count_year": 82,
    "location_launch_attempt_count_year": 18,
    "pad_launch_attempt_count_year": 8,
    "agency_launch_attempt_count_year": 12,
    "pad_turnaround": "P28DT19H31M",
    "mission_patches": [],
    "type": "detailed"
}