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/15183b48-9462-4eb7-b24e-eb6286605bb1/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "15183b48-9462-4eb7-b24e-eb6286605bb1",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/15183b48-9462-4eb7-b24e-eb6286605bb1/?format=api",
    "slug": "vls-1-scd-2a",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "VLS-1 | SCD-2A",
    "status": {
        "id": 4,
        "name": "Launch Failure",
        "abbrev": "Failure",
        "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate."
    },
    "last_updated": "2023-06-14T04:25:22Z",
    "updates": [],
    "net": "1997-11-02T12:25:00Z",
    "net_precision": null,
    "window_end": "1997-11-02T12:25:00Z",
    "window_start": "1997-11-02T12:25:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": null,
    "hashtag": null,
    "launch_service_provider": {
        "id": 12,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/12/?format=api",
        "name": "Brazilian Space Agency",
        "featured": false,
        "type": "Government",
        "country_code": "BRA",
        "abbrev": "AEB",
        "description": "The Brazilian Space Agency is a space agency in South America.  They work in partnership with the US and Russia aboard the ISS. It was previously operated by the military until 1994. They now operate largely in tandem with other nations. They run a spaceport and rocket launch site both in Brazil. They built the VLM small satellite launch system in tandem with Germany. The VLS-1 was intended to be a primary launch vehicle for the BSA, but it failed 3 times and was canceled. They have restarted work on the system in tandem with the Russian Space Agency.",
        "administrator": "Administrator: Marco Antonio Chamon",
        "founding_year": "1961",
        "launchers": "VLM | VLS",
        "spacecraft": "None",
        "launch_library_url": null,
        "total_launch_count": 2,
        "consecutive_successful_launches": 0,
        "successful_launches": 0,
        "failed_launches": 2,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.aeb.gov.br/",
        "wiki_url": "http://en.wikipedia.org/wiki/Brazilian_Space_Agency",
        "logo_url": null,
        "image_url": null,
        "nation_url": null
    },
    "rocket": {
        "id": 6814,
        "configuration": {
            "id": 448,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/448/?format=api",
            "name": "VLS-1",
            "active": false,
            "reusable": false,
            "description": "The VLS-1 was the Brazilian Space Agency's main satellite launch vehicle. The launch vehicle was to be capable of launching satellites into orbit. The launch site was located at the Alcântara Launch Center due to its proximity to the equator.",
            "family": "",
            "full_name": "VLS-1",
            "manufacturer": {
                "id": 1012,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1012/?format=api",
                "name": "Department of Aerospace Science and Technology",
                "featured": false,
                "type": "Government",
                "country_code": "BRA",
                "abbrev": "",
                "description": "The Brazilian Department of Science and Aerospace Technology is the national military research center for aviation and space flight. It is subordinated to the Brazilian Air Force (FAB). It coordinates all technical and scientific activities related to the aerospace sector in which there are interests by the Ministry of Defence. It was established in 1953. It currently employs several thousand civilian and military personnel.",
                "administrator": null,
                "founding_year": "1953",
                "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/Department_of_Aerospace_Science_and_Technology",
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "1",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 19.5,
            "diameter": 1.01,
            "maiden_flight": "1997-11-02",
            "launch_cost": null,
            "launch_mass": 50,
            "leo_capacity": 120,
            "gto_capacity": null,
            "to_thrust": 1172,
            "apogee": null,
            "vehicle_range": null,
            "image_url": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/VLS-1",
            "total_launch_count": 2,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "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": 5204,
        "name": "SCD-2A",
        "description": "The satellites of the SCD (Satelites de Coleta de Dados) series are equipped to collect and transmit meteorological and environmental data collected by automatic platforms (PCD) installed on land or on oceanic buoys. The data is relayed to one or more ground stations.",
        "launch_designator": null,
        "type": "Communications",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 146,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/146/?format=api",
        "agency_id": null,
        "name": "VLS Pad",
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Alc%C3%A2ntara_Launch_Center",
        "map_url": "https://www.google.com/maps?q=-2.3177,-44.369984",
        "latitude": "-2.3177",
        "longitude": "-44.369984",
        "location": {
            "id": 150,
            "url": "https://ll.thespacedevs.com/2.2.0/location/150/?format=api",
            "name": "Alcântara Space Center, Federative Republic of Brazil",
            "country_code": "BRA",
            "description": "The Alcântara Space Center, formerly known as Alcântara Launch Center is a space center and launching facility of the Brazilian Space Agency in the city of Alcântara, located on Brazil's northern Atlantic coast, in the state of Maranhão.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_150_20200803142405.jpg",
            "timezone_name": "America/Fortaleza",
            "total_launch_count": 2,
            "total_landing_count": 0
        },
        "country_code": "BRA",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_146_20200803143337.jpg",
        "total_launch_count": 2,
        "orbital_launch_attempt_count": 2
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": null,
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 4187,
    "location_launch_attempt_count": 1,
    "pad_launch_attempt_count": 1,
    "agency_launch_attempt_count": 1,
    "orbital_launch_attempt_count_year": 69,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P0D",
    "mission_patches": [],
    "type": "detailed"
}