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/05864985-e660-4723-b489-32a78d4b53fc/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "05864985-e660-4723-b489-32a78d4b53fc",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/05864985-e660-4723-b489-32a78d4b53fc/?format=api",
    "slug": "gaganyaan-abort-test-booster-tv-d2",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Gaganyaan Abort Test Booster | TV-D2",
    "status": {
        "id": 2,
        "name": "To Be Determined",
        "abbrev": "TBD",
        "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
    },
    "last_updated": "2024-12-21T14:30:23Z",
    "updates": [
        {
            "id": 7097,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Pushed to NET early 2024.",
            "info_url": "https://www.youtube.com/watch?v=X5DLYbWAIDw",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-25T23:27:11Z"
        },
        {
            "id": 5600,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Added launch",
            "info_url": "https://twitter.com/ISROSpaceflight/status/1720396271549297116",
            "created_by": "hitura-nobad",
            "created_on": "2023-11-03T12:12:09Z"
        }
    ],
    "net": "2025-12-31T00:00:00Z",
    "net_precision": {
        "id": 14,
        "name": "Year",
        "abbrev": "Y",
        "description": "The T-0 is expected in the given year."
    },
    "window_end": "2025-12-31T00:00:00Z",
    "window_start": "2025-12-31T00:00:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 31,
        "url": "https://ll.thespacedevs.com/2.2.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": 19,
        "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": 8084,
        "configuration": {
            "id": 497,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/497/?format=api",
            "name": "Gaganyaan Abort Test Booster",
            "active": true,
            "reusable": false,
            "description": "",
            "family": "",
            "full_name": "Gaganyaan Abort Test Booster",
            "manufacturer": {
                "id": 31,
                "url": "https://ll.thespacedevs.com/2.2.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": 19,
                "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": [
                {
                    "id": 21,
                    "url": "https://ll.thespacedevs.com/2.2.0/program/21/?format=api",
                    "name": "Gaganyaan",
                    "description": "Gaganyaan is India's first human spaceflight program.",
                    "agencies": [
                        {
                            "id": 31,
                            "url": "https://ll.thespacedevs.com/2.2.0/agencies/31/?format=api",
                            "name": "Indian Space Research Organization",
                            "type": "Government"
                        }
                    ],
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_program_20220120151540.jpg",
                    "start_date": "2018-08-15T00:00:00Z",
                    "end_date": null,
                    "info_url": "https://www.isro.gov.in/frequently-asked-questions/gaganyaan",
                    "wiki_url": "https://en.wikipedia.org/wiki/Gaganyaan",
                    "mission_patches": [],
                    "type": {
                        "id": 2,
                        "name": "Human Spaceflight"
                    }
                }
            ],
            "variant": "L40",
            "alias": "",
            "min_stage": 1,
            "max_stage": 1,
            "length": null,
            "diameter": null,
            "maiden_flight": "2023-10-21",
            "launch_cost": null,
            "launch_mass": null,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": 760,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_abort_image_20231021132156.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/TV-D1",
            "total_launch_count": 1,
            "consecutive_successful_launches": 1,
            "successful_launches": 1,
            "failed_launches": 0,
            "pending_launches": 1,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6638,
        "name": "TV-D2",
        "description": "The second inflight abort test of the Gaganyaan program.",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 15,
            "name": "Suborbital",
            "abbrev": "Sub"
        },
        "agencies": [
            {
                "id": 31,
                "url": "https://ll.thespacedevs.com/2.2.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": 19,
                "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"
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 50,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/50/?format=api",
        "agency_id": 31,
        "name": "Satish Dhawan Space Centre First Launch Pad",
        "description": "India has two launch pads at the site. The First Launch Pad, operational since 1993, is used for Polar Satellite Launch Vehicle, Small Satellite Launch Vehicle and formerly used by Geosynchronous Satellite Launch Vehicle.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_First_Launch_Pad",
        "map_url": "https://www.google.com/maps?q=13.733,80.235",
        "latitude": "13.733",
        "longitude": "80.235",
        "location": {
            "id": 14,
            "url": "https://ll.thespacedevs.com/2.2.0/location/14/?format=api",
            "name": "Satish Dhawan Space Centre, India",
            "country_code": "IND",
            "description": "Satish Dhawan Space Centre – SDSC (formerly Sriharikota Range – SHAR),[1] is the primary spaceport of the Indian Space Research Organisation (ISRO), located in Sriharikota, Andhra Pradesh.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg",
            "timezone_name": "Asia/Kolkata",
            "total_launch_count": 98,
            "total_landing_count": 0
        },
        "country_code": "IND",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_50_20200803143457.jpg",
        "total_launch_count": 61,
        "orbital_launch_attempt_count": 60
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_abort_image_20231021132156.jpeg",
    "infographic": null,
    "program": [
        {
            "id": 21,
            "url": "https://ll.thespacedevs.com/2.2.0/program/21/?format=api",
            "name": "Gaganyaan",
            "description": "Gaganyaan is India's first human spaceflight program.",
            "agencies": [
                {
                    "id": 31,
                    "url": "https://ll.thespacedevs.com/2.2.0/agencies/31/?format=api",
                    "name": "Indian Space Research Organization",
                    "type": "Government"
                }
            ],
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_program_20220120151540.jpg",
            "start_date": "2018-08-15T00:00:00Z",
            "end_date": null,
            "info_url": "https://www.isro.gov.in/frequently-asked-questions/gaganyaan",
            "wiki_url": "https://en.wikipedia.org/wiki/Gaganyaan",
            "mission_patches": [],
            "type": {
                "id": 2,
                "name": "Human Spaceflight"
            }
        }
    ],
    "orbital_launch_attempt_count": null,
    "location_launch_attempt_count": 110,
    "pad_launch_attempt_count": 66,
    "agency_launch_attempt_count": 106,
    "orbital_launch_attempt_count_year": 0,
    "location_launch_attempt_count_year": 13,
    "pad_launch_attempt_count_year": 5,
    "agency_launch_attempt_count_year": 13,
    "pad_turnaround": "P31D",
    "mission_patches": [],
    "type": "detailed"
}