Launch Instance
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/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api
{ "id": "a8c191e1-b231-4b2e-aefd-5e8ad55c7a82", "url": "https://ll.thespacedevs.com/2.2.0/launch/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api", "slug": "miura-5-maiden-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Miura 5 | Maiden Flight", "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-02-25T13:40:34Z", "updates": [ { "id": 6801, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://europeanspaceflight.com/esa-awards-e1-3m-in-co-funding-to-pld-for-miura-5-payload-adapter/", "created_by": "Cosmic_Penguin", "created_on": "2024-02-25T13:40:35Z" } ], "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": 1051, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "featured": false, "type": "Commercial", "country_code": "ESP", "abbrev": "PLD Space", "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": "2011", "launchers": "Miura 1 | Miura 5", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg" }, "rocket": { "id": 8207, "configuration": { "id": 509, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/509/?format=api", "name": "Miura 5", "active": true, "reusable": true, "description": "MIURA 5 is a 2 stage launch vehicle powered by liquid oxygen and kerosene. The vehicle is designed,\r\nintegrated and operated by PLD Space, and its 1st stage is designed to be eventually recovered by parachuting into the sea.", "family": "Miura", "full_name": "Miura 5", "manufacturer": { "id": 1051, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "featured": false, "type": "Commercial", "country_code": "ESP", "abbrev": "PLD Space", "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": "2011", "launchers": "Miura 1 | Miura 5", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 35.81, "diameter": 2.0, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 900, "gto_capacity": null, "to_thrust": 950, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "https://www.pldspace.com/en/miura-5", "wiki_url": "https://en.wikipedia.org/wiki/Miura_5", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "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": 6779, "name": "Maiden Flight", "description": "First flight of the Miura 5 launch vehicle.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 1051, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "featured": false, "type": "Commercial", "country_code": "ESP", "abbrev": "PLD Space", "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": "2011", "launchers": "Miura 1 | Miura 5", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 125, "url": "https://ll.thespacedevs.com/2.2.0/pad/125/?format=api", "agency_id": 115, "name": "Diamant Launch Area", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=5.2222222,-52.7758051", "latitude": "5.2222222", "longitude": "-52.7758051", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 325, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 7120, "location_launch_attempt_count": 343, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 271, "location_launch_attempt_count_year": 20, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P18357DT15H23M", "mission_patches": [], "type": "detailed" }
