Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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/dc5b8553-a2d7-4ffe-9f0a-c1a95d28fb28/?format=api
{ "id": "dc5b8553-a2d7-4ffe-9f0a-c1a95d28fb28", "url": "https://ll.thespacedevs.com/2.0.0/launch/dc5b8553-a2d7-4ffe-9f0a-c1a95d28fb28/?format=api", "launch_library_id": null, "slug": "vega-e-maiden-flight", "name": "Vega-E | Maiden flight", "status": { "id": 2, "name": "TBD" }, "net": "2027-12-31T00:00:00Z", "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 159, "url": "https://ll.thespacedevs.com/2.0.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 24, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "https://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "rocket": { "id": 8863, "configuration": { "id": 549, "launch_library_id": null, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/549/?format=api", "name": "Vega-E", "description": "", "family": "Vega", "full_name": "Vega-E", "manufacturer": { "id": 159, "url": "https://ll.thespacedevs.com/2.0.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 24, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "https://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 3, "max_stage": 3, "length": 36.8, "diameter": 3.0, "maiden_flight": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-e_render_image_20251225083722.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7454, "launch_library_id": null, "name": "Maiden flight", "description": "First flight of the upgraded Vega-E variant of the Vega launch vehicle developed by Avio.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" } }, "pad": { "id": 77, "url": "https://ll.thespacedevs.com/2.0.0/pad/77/?format=api", "agency_id": 115, "name": "Ariane Launch Area 3", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-3", "map_url": "https://www.google.com/maps?q=5.239,-52.768", "latitude": "5.239", "longitude": "-52.768", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "total_launch_count": 331, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_77_20200803143458.jpg", "total_launch_count": 118 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-e_render_image_20251225083722.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7486, "location_launch_attempt_count": 361, "pad_launch_attempt_count": 119, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 76, "location_launch_attempt_count_year": 15, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 9 }
