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/26881916-98e7-40bc-954c-88ad6ac7a050/?format=api
{ "id": "26881916-98e7-40bc-954c-88ad6ac7a050", "url": "https://ll.thespacedevs.com/2.2.0/launch/26881916-98e7-40bc-954c-88ad6ac7a050/?format=api", "slug": "unknown-exomars-2028-rosalind-franklin-rover", "flightclub_url": null, "r_spacex_api_id": null, "name": "Unknown | ExoMars 2028 Rosalind Franklin rover", "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-04-09T10:09:21Z", "updates": [ { "id": 7236, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET October 2028 from Florida, launch vehicle unknown", "info_url": "https://www.thalesaleniaspace.com/en/press-releases/search-life-mars-goes-exomars-2028", "created_by": "Nosu", "created_on": "2024-04-09T10:09:22Z" }, { "id": 1418, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Pushing to the end of the 2024 Mars transfer window following the temporary suspension of the ExoMars program by the European Space Agency.", "info_url": "https://www.esa.int/Newsroom/Press_Releases/ExoMars_suspended", "created_by": "Jay", "created_on": "2022-03-17T13:25:02Z" } ], "net": "2028-10-31T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2028-10-31T00:00:00Z", "window_start": "2028-10-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 183, "url": "https://ll.thespacedevs.com/2.2.0/agencies/183/?format=api", "name": "Unknown", "featured": false, "type": "Unknown", "country_code": "???", "abbrev": "UNK", "description": "The agency or launch service provider is not known yet.", "administrator": null, "founding_year": null, "launchers": "", "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": null, "wiki_url": "https://en.wikipedia.org/", "logo_url": null, "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg" }, "rocket": { "id": 160, "configuration": { "id": 511, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/511/?format=api", "name": "Unknown Launch Vehicle", "active": true, "reusable": false, "description": "", "family": "", "full_name": "Unknown Launch Vehicle", "manufacturer": { "id": 183, "url": "https://ll.thespacedevs.com/2.2.0/agencies/183/?format=api", "name": "Unknown", "featured": false, "type": "Unknown", "country_code": "???", "abbrev": "UNK", "description": "The agency or launch service provider is not known yet.", "administrator": null, "founding_year": null, "launchers": "", "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": null, "wiki_url": "https://en.wikipedia.org/", "logo_url": null, "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unknown_agency__image_20240409102110.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 918, "name": "ExoMars 2028 Rosalind Franklin Rover", "description": "ExoMars 2028 is a second mission of two-part European Space Agency astrobiology project to search for evidence of life on Mars. The primary objective is to land the rover at a site with high potential for finding well-preserved organic material, particularly from the very early history of the planet. The rover is expected to travel several kilometers during its mission. \r\n\r\nThe European rover will be the first mission to combine the capability to move across the surface and to study Mars at depth. It will collect samples with a drill down to a depth of 2 m and analyze them with next-generation instruments in an onboard laboratory. Underground samples are more likely to include biomarkers, since the tenuous martian atmosphere offers little protection from radiation and photochemistry at the surface.", "launch_designator": null, "type": "Robotic Exploration", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" }, "agencies": [ { "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" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 72, "url": "https://ll.thespacedevs.com/2.2.0/pad/72/?format=api", "agency_id": null, "name": "Unknown Pad", "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=28.458,-80.528", "latitude": "28.458", "longitude": "-80.528", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1023, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_72_20200803143403.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 7256, "location_launch_attempt_count": 1128, "pad_launch_attempt_count": 57, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 6, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P305D", "mission_patches": [], "type": "detailed" }
