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/4342580a-9380-47c8-803e-777265b3167b/?format=api
{ "id": "4342580a-9380-47c8-803e-777265b3167b", "url": "https://ll.thespacedevs.com/2.2.0/launch/4342580a-9380-47c8-803e-777265b3167b/?format=api", "slug": "vega-pleiades-neo-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega | Pléiades Neo 3", "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-06-14T03:49:38Z", "updates": [ { "id": 480, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful launch", "info_url": "https://twitter.com/Arianespace/status/1387612744862556162", "created_by": "Nosu", "created_on": "2021-04-29T03:40:44Z" }, { "id": 463, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launch date is confirmed by Arianespace.", "info_url": "https://twitter.com/Arianespace/status/1385582225681432577", "created_by": "spacevogel", "created_on": "2021-04-23T13:50:47Z" }, { "id": 445, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch is now planned for Apr 28", "info_url": "https://www.intelligence-airbusds.com/imagery/constellation/pleiades-neo/", "created_by": "Nosu", "created_on": "2021-04-13T20:47:12Z" }, { "id": 430, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launch is now planned for Apr 27", "info_url": "https://www.intelligence-airbusds.com/imagery/constellation/pleiades-neo/", "created_by": "spacevogel", "created_on": "2021-04-08T05:47:29Z" }, { "id": 425, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "The countdown on Airbus website points to a Apr 20 01:50 UTC launch time.", "info_url": "https://www.intelligence-airbusds.com/newsroom/news/pleiades-neo-ready-for-launch/", "created_by": "spacevogel", "created_on": "2021-03-31T10:49:11Z" }, { "id": 336, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launch is NET April 22", "info_url": "https://twitter.com/Avio_Group/status/1368532355086966786", "created_by": "spacevogel", "created_on": "2021-03-07T13:06:27Z" } ], "net": "2021-04-29T01:50:00Z", "net_precision": null, "window_end": "2021-04-29T01:50:00Z", "window_start": "2021-04-29T01:50:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 319, "consecutive_successful_launches": 7, "successful_launches": 304, "failed_launches": 15, "pending_launches": 48, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.arianespace.com", "wiki_url": "http://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 152, "configuration": { "id": 167, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/167/?format=api", "name": "Vega", "active": false, "reusable": false, "description": "Vega is the smallest lifter in the current Arianespace family.", "family": "Vega", "full_name": "Vega", "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": 29.9, "diameter": 3.025, "maiden_flight": "2012-02-13", "launch_cost": "37000000", "launch_mass": 137, "leo_capacity": 1500, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg", "info_url": "http://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 22, "consecutive_successful_launches": 5, "successful_launches": 20, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1263, "name": "Pléiades Neo 3", "description": "Pléiades Neo is a constellation of four optical high-resolution Earth observation satellites built and operated by Airbus. It is a dual purpose constellation, serving both civilian and military purposes. Pléiades Neo 3 is the first satellite in the constellation which is to deliver imagery with spatial resolution of 30 cm. It is launched along with several rideshare payloads.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "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": 0, "source": null, "publisher": null, "title": "Vega Pléiades Neo 3", "description": "Vega Pléiades Neo 3 with initial coverage and post coverage cutThumbnail Photo Credit: ESA/CNES/Arianespace", "feature_image": "https://i.ytimg.com/vi/K-Utj8foOaM/maxresdefault.jpg", "url": "https://youtu.be/K-Utj8foOaM", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Arianespace Flight VV18 – Pléiades Neo 3 / Norsat-3 / 4 cubesats (EN)", "description": "On Wednesday, April 28, 2021 at 10:50 pm local time (01:50 UTC on Thursday, April 29), Arianespace’s first Vega mission of the year will lift off from the Gu...", "feature_image": "https://i.ytimg.com/vi/Il3SiRdFW8w/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=Il3SiRdFW8w", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/vega2520257c_infographic_20210429010508.jpeg", "program": [], "orbital_launch_attempt_count": 6072, "location_launch_attempt_count": 305, "pad_launch_attempt_count": 44, "agency_launch_attempt_count": 295, "orbital_launch_attempt_count_year": 35, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P162DT23H57M40S", "mission_patches": [ { "id": 73, "name": "Pléiades Neo", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/pl25c325a9iad_mission_patch_20210813080635.png", "agency": { "id": 178, "url": "https://ll.thespacedevs.com/2.2.0/agencies/178/?format=api", "name": "Airbus Defence and Space", "type": "Multinational" } } ], "type": "detailed" }
