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/f8f0f404-f149-4c1a-89ba-0022d19f4b9e/?format=api
{ "id": "f8f0f404-f149-4c1a-89ba-0022d19f4b9e", "url": "https://ll.thespacedevs.com/2.2.0/launch/f8f0f404-f149-4c1a-89ba-0022d19f4b9e/?format=api", "slug": "spaceshiptwo-purdue-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "SpaceShipTwo | Purdue 1", "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": "2025-09-29T09:37:44Z", "updates": [ { "id": 12408, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding flight", "info_url": "https://spacenews.com/purdue-university-to-fly-dedicated-suborbital-research-mission-with-virgin-galactic/", "created_by": "Nosu", "created_on": "2025-09-29T09:37:00Z" } ], "net": "2027-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "VG", "description": "Virgin Galactic is an American spaceflight company within the Virgin Group. It is developing commercial spacecraft and aims to provide suborbital spaceflights to space tourists. Virgin Galactic's suborbital spacecraft are air launched from beneath a carrier airplane known as White Knight Two.", "administrator": "Founder: Richard Branson", "founding_year": "2004", "launchers": "VMS Eve", "spacecraft": "VSS Enterprise | VSS Unity", "launch_library_url": null, "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.virgingalactic.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Galactic", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_logo_20230509082346.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_nation_20230617045127.jpg" }, "rocket": { "id": 8731, "configuration": { "id": 465, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/465/?format=api", "name": "SpaceShipTwo", "active": true, "reusable": true, "description": "The Scaled Composites Model 339 SpaceShipTwo (SS2) is an air-launched suborbital spaceplane type designed for space tourism. It is manufactured by The Spaceship Company, a California-based company owned by Virgin Galactic.", "family": "", "full_name": "SpaceShipTwo", "manufacturer": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "VG", "description": "Virgin Galactic is an American spaceflight company within the Virgin Group. It is developing commercial spacecraft and aims to provide suborbital spaceflights to space tourists. Virgin Galactic's suborbital spacecraft are air launched from beneath a carrier airplane known as White Knight Two.", "administrator": "Founder: Richard Branson", "founding_year": "2004", "launchers": "VMS Eve", "spacecraft": "VSS Enterprise | VSS Unity", "launch_library_url": null, "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.virgingalactic.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Galactic", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_logo_20230509082346.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_nation_20230617045127.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 18.0, "diameter": 8.2, "maiden_flight": "2010-10-10", "launch_cost": null, "launch_mass": 9, "leo_capacity": 0, "gto_capacity": 0, "to_thrust": 310, "apogee": 110, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceshiptwo_image_20210522140909.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceShipTwo", "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7322, "name": "Purdue 1", "description": "Suborbital research flight for Purdue University carrying a professor, student and three alumni.", "launch_designator": null, "type": "Materials Science", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 191, "url": "https://ll.thespacedevs.com/2.2.0/pad/191/?format=api", "agency_id": 1024, "name": "Spaceport America", "description": null, "info_url": "https://www.spaceportamerica.com/", "wiki_url": "https://en.wikipedia.org/wiki/Spaceport_America", "map_url": "https://www.google.com/maps?q=32.9902778,-106.9719162", "latitude": "32.9902778", "longitude": "-106.9719162", "location": { "id": 144, "url": "https://ll.thespacedevs.com/2.2.0/location/144/?format=api", "name": "Air launch to Suborbital flight", "country_code": "???", "description": "", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_144_20200803142439.jpg", "timezone_name": "", "total_launch_count": 86, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_spaceport_america_20210522162030.jpg", "total_launch_count": 14, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceshiptwo_image_20210522140909.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 87, "pad_launch_attempt_count": 15, "agency_launch_attempt_count": 68, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1300DT8H34M", "mission_patches": [], "type": "detailed" }
