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/b8173cec-0f32-4268-bbb6-af7bab0be436/?format=api
{ "id": "b8173cec-0f32-4268-bbb6-af7bab0be436", "url": "https://ll.thespacedevs.com/2.2.0/launch/b8173cec-0f32-4268-bbb6-af7bab0be436/?format=api", "slug": "vega-c-lares-2-maiden-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | LARES-2 (Maiden flight)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-11-07T09:36:16Z", "updates": [ { "id": 2078, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launch announced a success on the webcast", "info_url": null, "created_by": "spacevogel", "created_on": "2022-07-13T15:30:26Z" }, { "id": 2077, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Liftoff", "info_url": null, "created_by": "spacevogel", "created_on": "2022-07-13T13:13:42Z" }, { "id": 2076, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "New T-0", "info_url": null, "created_by": "spacevogel", "created_on": "2022-07-13T12:58:08Z" }, { "id": 2075, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "New T-0", "info_url": null, "created_by": "spacevogel", "created_on": "2022-07-13T11:40:15Z" }, { "id": 2030, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Setting GO and adjusting NET", "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Vega/Vega-C_inaugural_flight_VV21_media_kit", "created_by": "Jay", "created_on": "2022-07-04T18:06:53Z" }, { "id": 2029, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "NET July 13, pending suitable conditions for launch", "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Vega/Vega-C_set_for_inaugural_launch", "created_by": "Jay", "created_on": "2022-07-04T17:56:42Z" }, { "id": 1932, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Setting GO", "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Vega/Vega-C_inaugural_flight_VV21_media_kit", "created_by": "SwGustav", "created_on": "2022-06-21T16:55:28Z" }, { "id": 1828, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting July 7 at 11:13 UTC", "info_url": "https://twitter.com/SciGuySpace/status/1534177342003810308", "created_by": "Nosu", "created_on": "2022-06-07T16:09:58Z" }, { "id": 1826, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July 7", "info_url": "https://twitter.com/nasaspaceflight/status/1534180221607452673?s=21&t=uqCkqmqLIsAVryOteNvuIg", "created_by": "Cosmic_Penguin", "created_on": "2022-06-07T14:30:24Z" }, { "id": 1762, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting the first week of July", "info_url": "https://spacenews.com/arianespace-narrows-vega-c-and-ariane-6-maiden-flight-windows/", "created_by": "Nosu", "created_on": "2022-06-01T15:35:00Z" }, { "id": 1706, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July 2022", "info_url": "https://www.esa.int/Newsroom/Press_Releases/Invitation_to_media_Join_pre-launch_press_programme_to_see_Vega-C_and_preparations_for_Ariane_6_at_Europe_s_Spaceport", "created_by": "Cosmic_Penguin", "created_on": "2022-05-19T17:03:39Z" }, { "id": 1224, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET May", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-01-28T20:06:18Z" }, { "id": 988, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET April 2022", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2021-11-17T17:03:07Z" } ], "net": "2022-07-13T13:13:17Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2022-07-13T13:13:17Z", "window_start": "2022-07-13T13:13:17Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN", "abbrev": "ESA", "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.", "administrator": "Director General: Josef Aschbacher", "founding_year": "1975", "launchers": "Ariane | Vega", "spacecraft": "Space Rider", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.esa.int/", "wiki_url": "http://en.wikipedia.org/wiki/European_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png" }, "rocket": { "id": 2471, "configuration": { "id": 127, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/127/?format=api", "name": "Vega-C", "active": true, "reusable": false, "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.", "family": "Vega", "full_name": "Vega-C", "manufacturer": { "id": 159, "url": "https://ll.thespacedevs.com/2.2.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": 3, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "http://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": 4, "max_stage": 4, "length": 35.0, "diameter": 3.0, "maiden_flight": "2022-07-13", "launch_cost": "48000000", "launch_mass": 210, "leo_capacity": 3300, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "info_url": "http://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 4, "consecutive_successful_launches": 2, "successful_launches": 3, "failed_launches": 1, "pending_launches": 23, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6086, "name": "LARES-2 (Maiden flight)", "description": "Maiden flight of the Vega-C launch vehicle, carrying the LARES-2 passive satellite. It is a 40 cm diameter sphere with laser mirrors to study the Earth gravitational field and relativistic effects. Also onboard are six European research cubesats.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "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_34_20200803143527.jpg", "total_launch_count": 52, "orbital_launch_attempt_count": 52 }, "infoURLs": [], "vidURLs": [ { "priority": 9, "source": null, "publisher": null, "title": "Vega-C launch", "description": "The inaugural flight of ESA’s new Vega-C rocket is set for 13 July at 13:13 CEST. The principal payload of flight VV21 is LARES-2, a scientific mission of th...", "feature_image": "https://i.ytimg.com/vi/_uXUM6xC0Vk/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=_uXUM6xC0Vk", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Vega-C launch (operational audio only)", "description": "The inaugural flight of ESA’s new Vega-C rocket is set for 13 July at 13:13 CEST. The principal payload of flight VV21 is LARES-2, a scientific mission of th...", "feature_image": "https://i.ytimg.com/vi/sJTm-3QxDQc/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=sJTm-3QxDQc", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6265, "location_launch_attempt_count": 314, "pad_launch_attempt_count": 47, "agency_launch_attempt_count": 6, "orbital_launch_attempt_count_year": 83, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P239DT3H45M22S", "mission_patches": [], "type": "detailed" }
