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/83f38440-8a73-4209-911d-fb4f30b1bda9/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "83f38440-8a73-4209-911d-fb4f30b1bda9",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/83f38440-8a73-4209-911d-fb4f30b1bda9/?format=api",
    "slug": "atlas-v-541-ussf-12",
    "flightclub_url": "https://flightclub.io/result?llId=83f38440-8a73-4209-911d-fb4f30b1bda9",
    "r_spacex_api_id": null,
    "name": "Atlas V 541 | USSF-12",
    "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
    },
    "last_updated": "2024-03-05T17:44:32Z",
    "updates": [
        {
            "id": 2020,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Launch success confirmed",
            "info_url": "https://twitter.com/ulalaunch/status/1543115741595156480",
            "created_by": "SwGustav",
            "created_on": "2022-07-02T06:35:28Z"
        },
        {
            "id": 2018,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Liftoff",
            "info_url": "https://www.youtube.com/watch?v=bq7XexCXqaI",
            "created_by": "Jay",
            "created_on": "2022-07-01T23:15:20Z"
        },
        {
            "id": 2017,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Hold released at L-16 minutes",
            "info_url": null,
            "created_by": "Jay",
            "created_on": "2022-07-01T23:00:05Z"
        },
        {
            "id": 2016,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "New T-0 of 23:15:00 UTC",
            "info_url": null,
            "created_by": "Jay",
            "created_on": "2022-07-01T22:52:03Z"
        },
        {
            "id": 2015,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Expected clear time now 22:45 UTC",
            "info_url": "https://24live.co/live/UqXJY?n=3085996221675286925",
            "created_by": "Jay",
            "created_on": "2022-07-01T22:28:30Z"
        },
        {
            "id": 2013,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Awaiting clearance of the anvil cloud rule violation",
            "info_url": null,
            "created_by": "Jay",
            "created_on": "2022-07-01T21:50:15Z"
        },
        {
            "id": 2012,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Webcast live",
            "info_url": "https://www.youtube.com/watch?v=bq7XexCXqaI",
            "created_by": "Jay",
            "created_on": "2022-07-01T21:39:33Z"
        },
        {
            "id": 2011,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Weather 50%. Anvil cloud rule remains the primary concern.",
            "info_url": "https://twitter.com/ulalaunch/status/1542970368931012608",
            "created_by": "Jay",
            "created_on": "2022-07-01T21:09:59Z"
        },
        {
            "id": 2009,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Weather 40%",
            "info_url": "https://twitter.com/ulalaunch/status/1542944683579641856",
            "created_by": "Jay",
            "created_on": "2022-07-01T19:05:20Z"
        },
        {
            "id": 2008,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Weather 20%",
            "info_url": "https://twitter.com/ulalaunch/status/1542904024449650694",
            "created_by": "Jay",
            "created_on": "2022-07-01T16:15:12Z"
        },
        {
            "id": 2007,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Weather 40%",
            "info_url": "https://twitter.com/ulalaunch/status/1542880728140193793",
            "created_by": "Jay",
            "created_on": "2022-07-01T14:44:49Z"
        },
        {
            "id": 2006,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Scrub and 24h recycle due to poor weather conditions",
            "info_url": "https://twitter.com/ulalaunch/status/1542652810348601345",
            "created_by": "SwGustav",
            "created_on": "2022-06-30T23:35:09Z"
        },
        {
            "id": 2005,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Webcast live, holding the countdown due to technical issues and poor weather",
            "info_url": "https://www.youtube.com/watch?v=RGnlt-vto7o",
            "created_by": "SwGustav",
            "created_on": "2022-06-30T21:43:42Z"
        },
        {
            "id": 1980,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added launch window per marine space closure notices and Space Launch Delta 45 weather report",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=50618.msg2380552#msg2380552",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-26T16:23:43Z"
        },
        {
            "id": 1979,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Weather 70%",
            "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Atlas%20V%20USSF-12%20L-4%20Forecast%20-%2030%20Jun%20Launch.pdf?ver=MvhAwyKt_sbhM5o3f0C96Q%3d%3d",
            "created_by": "Jay",
            "created_on": "2022-06-26T15:50:45Z"
        },
        {
            "id": 1986,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Set GO",
            "info_url": "https://twitter.com/ulalaunch/status/1541448537099100160?s=20&t=RSEIwIbA5gxtTvR5IRGIvA",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-27T15:52:40Z"
        },
        {
            "id": 1985,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Weather 60%",
            "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Atlas%20V%20USSF-12%20L-3%20Forecast%20-%2030%20Jun%20Launch.pdf",
            "created_by": "Nosu",
            "created_on": "2022-06-27T14:46:41Z"
        },
        {
            "id": 1937,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Moved to June 30",
            "info_url": "https://twitter.com/ulalaunch/status/1539651175645323264?s=21&t=M0t3dxyKdn4yk4qGInPnOQ",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-06-22T16:48:39Z"
        },
        {
            "id": 1712,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET June 29",
            "info_url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-ussf-12",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-05-20T08:50:14Z"
        },
        {
            "id": 1397,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed to behind OFT-2 due to payload issues.",
            "info_url": "https://twitter.com/ulalaunch/status/1501558866483548166?s=21",
            "created_by": "Cosmic_Penguin",
            "created_on": "2022-03-09T14:03:28Z"
        },
        {
            "id": 1226,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Updating launcher configuration",
            "info_url": "https://spaceflightnow.com/launch-schedule/",
            "created_by": "Nosu",
            "created_on": "2022-01-28T20:32:40Z"
        }
    ],
    "net": "2022-07-01T23:15:00Z",
    "net_precision": null,
    "window_end": "2022-07-02T00:00:00Z",
    "window_start": "2022-07-01T22:00:00Z",
    "probability": 50,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": "USSF12",
    "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": 147,
        "configuration": {
            "id": 1,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/1/?format=api",
            "name": "Atlas V 541",
            "active": true,
            "reusable": false,
            "description": "Atlas V with 5m Fairing, 4 SRB, 1 Centaur upper stage engine.",
            "family": "Atlas",
            "full_name": "Atlas V 541",
            "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": "541",
            "alias": "",
            "min_stage": 0,
            "max_stage": 2,
            "length": 60.0,
            "diameter": 3.8,
            "maiden_flight": "2011-11-26",
            "launch_cost": "145000000",
            "launch_mass": 479,
            "leo_capacity": 17410,
            "gto_capacity": 8290,
            "to_thrust": null,
            "apogee": 40000,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520541_image_20190224012314.jpeg",
            "info_url": "https://www.ulalaunch.com/rockets/atlas-v",
            "wiki_url": null,
            "total_launch_count": 9,
            "consecutive_successful_launches": 9,
            "successful_launches": 9,
            "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": 6082,
        "name": "USSF-12",
        "description": "Two US national security payloads. The first is the Space Force's Wide Field of View (WFOV) Testbed satellite, the second is a multi-manifest satellite for the Department of Defense (DoD).",
        "launch_designator": null,
        "type": "Government/Top Secret",
        "orbit": {
            "id": 3,
            "name": "Geosynchronous Orbit",
            "abbrev": "GSO"
        },
        "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": [
        {
            "priority": 10,
            "source": null,
            "title": "Atlas V USSF-12",
            "description": "A United Launch Alliance (ULA) Atlas V 541 rocket is launching the USSF-12 mission for the U.S. Space Force’s Space Systems Command (SSC). USSF-12 features two satellite payloads: the Wide Field of View (WFOV) Testbed for SSC's Space Sensing Directorate and the USSF-12 Ring spacecraft for the Defens...",
            "feature_image": null,
            "url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-ussf-12",
            "type": null,
            "language": null
        }
    ],
    "vidURLs": [
        {
            "priority": 10,
            "source": null,
            "publisher": null,
            "title": "July 1 Live Broadcast: Atlas V USSF-12",
            "description": "Watch live on Friday, July 1, 2022, as ULA's Atlas V rocket lifts off from Cape Canaveral Space Force Station with the  U.S. Space Force (USSF)-12 mission fo...",
            "feature_image": "https://i.ytimg.com/vi/bq7XexCXqaI/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=bq7XexCXqaI",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 11,
            "source": null,
            "publisher": null,
            "title": "SCRUBBED: June 30 Live Broadcast: Atlas V USSF-12",
            "description": "Watch live on Thursday, June 30, 2022, as ULA's Atlas V rocket lifts off from Cape Canaveral Space Force Station with the  U.S. Space Force (USSF)-12 mission...",
            "feature_image": "https://i.ytimg.com/vi/RGnlt-vto7o/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=RGnlt-vto7o",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v252_image_20220629172200.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6258,
    "location_launch_attempt_count": 849,
    "pad_launch_attempt_count": 106,
    "agency_launch_attempt_count": 152,
    "orbital_launch_attempt_count_year": 76,
    "location_launch_attempt_count_year": 19,
    "pad_launch_attempt_count_year": 4,
    "agency_launch_attempt_count_year": 4,
    "pad_turnaround": "P43DT20M13S",
    "mission_patches": [
        {
            "id": 743,
            "name": "US Space Force Patch",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/us2520space25_mission_patch_20221102113104.png",
            "agency": {
                "id": 1041,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api",
                "name": "United States Space Force",
                "type": "Government"
            }
        }
    ],
    "type": "detailed"
}