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/220e6d9f-33dc-4533-8a48-535ba4c559e2/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "220e6d9f-33dc-4533-8a48-535ba4c559e2",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/220e6d9f-33dc-4533-8a48-535ba4c559e2/?format=api",
    "launch_library_id": 2030,
    "slug": "gslv-idrss-2",
    "name": "GSLV | IDRSS-2",
    "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": 31,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/31/?format=api",
        "name": "Indian Space Research Organization",
        "featured": true,
        "type": "Government",
        "country_code": "IND",
        "abbrev": "ISRO",
        "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
        "administrator": "Chairman: V. Narayanan",
        "founding_year": "1969",
        "launchers": "PSLV | GSLV",
        "spacecraft": "Gaganyaan",
        "launch_library_url": null,
        "total_launch_count": 94,
        "consecutive_successful_launches": 16,
        "successful_launches": 81,
        "failed_launches": 13,
        "pending_launches": 17,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.isro.gov.in/",
        "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
    },
    "rocket": {
        "id": 2617,
        "configuration": {
            "id": 168,
            "launch_library_id": 60,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/168/?format=api",
            "name": "GSLV Mk II",
            "description": "Geosynchronous Satellite Launch Vehicle Mark II (GSLV Mk II) is the largest launch vehicle developed by India, which is currently in operation. This fourth generation launch vehicle is a three stage vehicle with four liquid strap-ons. The indigenously developed cryogenic Upper Stage (CUS), which is flight proven, forms the third stage of GSLV Mk II. From January 2014, the vehicle has achieved four consecutive successes.",
            "family": "GSLV",
            "full_name": "GSLV Mk. II",
            "manufacturer": {
                "id": 31,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/31/?format=api",
                "name": "Indian Space Research Organization",
                "featured": true,
                "type": "Government",
                "country_code": "IND",
                "abbrev": "ISRO",
                "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
                "administrator": "Chairman: V. Narayanan",
                "founding_year": "1969",
                "launchers": "PSLV | GSLV",
                "spacecraft": "Gaganyaan",
                "launch_library_url": null,
                "total_launch_count": 94,
                "consecutive_successful_launches": 16,
                "successful_launches": 81,
                "failed_launches": 13,
                "pending_launches": 17,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.isro.gov.in/",
                "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 0,
            "max_stage": 3,
            "length": 49.0,
            "diameter": 2.8,
            "maiden_flight": "2010-04-15",
            "launch_mass": 401,
            "leo_capacity": 0,
            "gto_capacity": 2500,
            "to_thrust": 7420,
            "apogee": 40000,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520ii_image_20190825171642.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Geosynchronous_Satellite_Launch_Vehicle",
            "total_launch_count": 11,
            "consecutive_successful_launches": 3,
            "successful_launches": 9,
            "failed_launches": 2,
            "pending_launches": 6
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": null,
    "pad": {
        "id": 82,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/82/?format=api",
        "agency_id": 31,
        "name": "Satish Dhawan Space Centre Second Launch Pad",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_Second_Launch_Pad",
        "map_url": "https://www.google.com/maps?q=13.7199,80.2304",
        "latitude": "13.7199",
        "longitude": "80.2304",
        "location": {
            "id": 14,
            "url": "https://ll.thespacedevs.com/2.0.0/location/14/?format=api",
            "name": "Satish Dhawan Space Centre, India",
            "country_code": "IND",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg",
            "total_launch_count": 98,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_82_20200803143602.jpg",
        "total_launch_count": 29
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520ii_image_20190825171642.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7113,
    "location_launch_attempt_count": 112,
    "pad_launch_attempt_count": 38,
    "agency_launch_attempt_count": 108,
    "orbital_launch_attempt_count_year": 7113,
    "location_launch_attempt_count_year": 15,
    "pad_launch_attempt_count_year": 10,
    "agency_launch_attempt_count_year": 15
}