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/cb0c27fd-496c-4f74-aa04-9c0e5af33e3c/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "cb0c27fd-496c-4f74-aa04-9c0e5af33e3c",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/cb0c27fd-496c-4f74-aa04-9c0e5af33e3c/?format=api",
    "launch_library_id": 1308,
    "slug": "epsilon-s-jv-lotusat-1",
    "name": "Epsilon S | JV-LOTUSat-1",
    "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": 37,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/37/?format=api",
        "name": "Japan Aerospace Exploration Agency",
        "featured": true,
        "type": "Government",
        "country_code": "JPN",
        "abbrev": "JAXA",
        "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.",
        "administrator": "Administrator: Hiroshi Yamakawa",
        "founding_year": "2003",
        "launchers": "H-II",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 36,
        "consecutive_successful_launches": 1,
        "successful_launches": 32,
        "failed_launches": 4,
        "pending_launches": 4,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.jaxa.jp/",
        "wiki_url": "http://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png"
    },
    "rocket": {
        "id": 63,
        "configuration": {
            "id": 115,
            "launch_library_id": 161,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/115/?format=api",
            "name": "Epsilon S",
            "description": "The Epsilon S rocket is a Japanese solid-fuel rocket designed to launch scientific satellites. It is a follow-on project to the larger and more expensive M-V rocket which was retired in 2006. The Japan Aerospace Exploration Agency (JAXA) began developing the Epsilon in 2007. The first stage is based on SRB-3, the strap-on solid-rocket booster of H3",
            "family": "Epsilon",
            "full_name": "Epsilon S",
            "manufacturer": {
                "id": 37,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/37/?format=api",
                "name": "Japan Aerospace Exploration Agency",
                "featured": true,
                "type": "Government",
                "country_code": "JPN",
                "abbrev": "JAXA",
                "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.",
                "administrator": "Administrator: Hiroshi Yamakawa",
                "founding_year": "2003",
                "launchers": "H-II",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 36,
                "consecutive_successful_launches": 1,
                "successful_launches": 32,
                "failed_launches": 4,
                "pending_launches": 4,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.jaxa.jp/",
                "wiki_url": "http://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png"
            },
            "program": [],
            "variant": "S",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 24.4,
            "diameter": 2.5,
            "maiden_flight": "2013-09-14",
            "launch_mass": 91,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": 2158,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/epsilon_image_20190207032600.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Epsilon_(rocket)#Epsilon_S",
            "total_launch_count": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 3
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6983,
        "launch_library_id": null,
        "name": "JV-LOTUSat-1",
        "description": "Vietnamese Synthetic Aperture Radar Earth observation satellite build by NEC Corporation of Japan, based on Japan's ASNARO 2 satellite and the NEXTAR NX-300L satellite bus. The satellite will contribute to measures against natural disasters and climate change in Vietnam.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 47,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/47/?format=api",
        "agency_id": 37,
        "name": "Mu Center",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Uchinoura_Space_Center",
        "map_url": "https://www.google.com/maps?q=31.2509794,131.0821319",
        "latitude": "31.2509794",
        "longitude": "131.0821319",
        "location": {
            "id": 24,
            "url": "https://ll.thespacedevs.com/2.0.0/location/24/?format=api",
            "name": "Uchinoura Space Center, Japan",
            "country_code": "JPN",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_24_20200803142411.jpg",
            "total_launch_count": 43,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_47_20200803143524.jpg",
        "total_launch_count": 36
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/epsilon_image_20190207032600.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7113,
    "location_launch_attempt_count": 45,
    "pad_launch_attempt_count": 38,
    "agency_launch_attempt_count": 39,
    "orbital_launch_attempt_count_year": 264,
    "location_launch_attempt_count_year": 2,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 3
}