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/98f70f28-397a-4c0d-aeb2-e7f8a88e0323/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "98f70f28-397a-4c0d-aeb2-e7f8a88e0323",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/98f70f28-397a-4c0d-aeb2-e7f8a88e0323/?format=api",
    "launch_library_id": null,
    "slug": "vulcan-gps-iii-sv09",
    "name": "Vulcan | GPS III SV09",
    "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": 124,
        "url": "https://ll.thespacedevs.com/2.0.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": 7899,
        "configuration": {
            "id": 200,
            "launch_library_id": 226,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/200/?format=api",
            "name": "Vulcan",
            "description": "Vulcan",
            "family": "Vulcan",
            "full_name": "Vulcan",
            "manufacturer": {
                "id": 124,
                "url": "https://ll.thespacedevs.com/2.0.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": "Vulcan",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": null,
            "diameter": 5.4,
            "maiden_flight": null,
            "launch_mass": null,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg",
            "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur",
            "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur#Certification_flights",
            "total_launch_count": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 26
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6408,
        "launch_library_id": null,
        "name": "GPS III SV09",
        "description": "Ninth of ten GPS III missions.",
        "launch_designator": null,
        "type": "Navigation",
        "orbit": {
            "id": 12,
            "name": "Medium Earth Orbit",
            "abbrev": "MEO"
        }
    },
    "pad": {
        "id": 29,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/29/?format=api",
        "agency_id": null,
        "name": "Space Launch Complex 41",
        "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.0.0/location/12/?format=api",
            "name": "Cape Canaveral SFS, FL, USA",
            "country_code": "USA",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
            "total_launch_count": 1020,
            "total_landing_count": 64
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg",
        "total_launch_count": 115
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg",
    "infographic": null,
    "program": [
        {
            "id": 29,
            "url": "https://ll.thespacedevs.com/2.0.0/program/29/?format=api",
            "name": "Global Positioning System",
            "description": "The Global Positioning System (GPS), originally Navstar GPS, is a satellite-based radio navigation system owned by the United States government and operated by the United States Space Force. It is one of the global navigation satellite systems (GNSS) that provide geolocation and time information to a GPS receiver anywhere on or near the Earth where there is an unobstructed line of sight to four or more GPS satellites.",
            "agencies": [
                {
                    "id": 1041,
                    "url": "https://ll.thespacedevs.com/2.0.0/agencies/1041/?format=api",
                    "name": "United States Space Force",
                    "type": "Government"
                }
            ],
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/global2520posi_program_20231229182501.png",
            "start_date": "1978-02-22T00:00:00Z",
            "end_date": null,
            "info_url": "https://www.gps.gov/",
            "wiki_url": "https://en.wikipedia.org/wiki/Global_Positioning_System"
        }
    ],
    "orbital_launch_attempt_count": 7113,
    "location_launch_attempt_count": 1075,
    "pad_launch_attempt_count": 138,
    "agency_launch_attempt_count": 191,
    "orbital_launch_attempt_count_year": 264,
    "location_launch_attempt_count_year": 81,
    "pad_launch_attempt_count_year": 24,
    "agency_launch_attempt_count_year": 27
}