Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/launches/0914dabd-ac92-444b-bf9f-7a6b08bb06e1/?format=api
{ "id": "0914dabd-ac92-444b-bf9f-7a6b08bb06e1", "url": "https://ll.thespacedevs.com/2.3.0/launches/0914dabd-ac92-444b-bf9f-7a6b08bb06e1/?format=api", "name": "LauncherOne | Above the Clouds", "response_mode": "detailed", "slug": "launcherone-above-the-clouds", "launch_designator": "2022-003", "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:54:38Z", "net": "2022-01-13T22:52:00Z", "net_precision": null, "window_end": "2022-01-14T00:50:00Z", "window_start": "2022-01-13T22:20:00Z", "image": { "id": 1760, "name": "[AUTO] LauncherOne - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/launcherone_image_20200101110016.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193706.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": -1, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 199, "url": "https://ll.thespacedevs.com/2.3.0/agencies/199/?format=api", "name": "Virgin Orbit", "abbrev": "VO", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Virgin Orbit is a company within the Virgin Group which plans to provide launch services for small satellites. The company was formed in 2017 to develop the air-launched LauncherOne rocket, launched from Cosmic Girl, which had previously been a project of Virgin Galactic. Based in Long Beach, California, Virgin Orbit has more than 300 employees led by president Dan Hart, a former vice president of government satellite systems at Boeing.\r\n\r\nVirgin Orbit focuses on small satellite launch, which is one of three capabilities being focused on by Virgin Galactic. These capabilities are: human spaceflight operations, small satellite launch, and advanced aerospace design, manufacturing, and test", "administrator": "President: Dan Hart", "founding_year": 2017, "launchers": "LauncherOne", "spacecraft": "", "parent": null, "image": { "id": 33, "name": "Virgin Orbit LauncherOne", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184714.jpeg", "credit": "Virgin Orbit", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 197, "name": "[AUTO] Virgin Orbit - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_logo_20200101102856.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185202.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 102, "name": "[AUTO] Virgin Orbit - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_nation_20200101103026.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184859.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://virginorbit.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Orbit", "social_media_links": [] }, "rocket": { "id": 2464, "configuration": { "response_mode": "detailed", "id": 141, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/141/?format=api", "name": "LauncherOne", "families": [], "full_name": "LauncherOne", "variant": "One", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 199, "url": "https://ll.thespacedevs.com/2.3.0/agencies/199/?format=api", "name": "Virgin Orbit", "abbrev": "VO", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Virgin Orbit is a company within the Virgin Group which plans to provide launch services for small satellites. The company was formed in 2017 to develop the air-launched LauncherOne rocket, launched from Cosmic Girl, which had previously been a project of Virgin Galactic. Based in Long Beach, California, Virgin Orbit has more than 300 employees led by president Dan Hart, a former vice president of government satellite systems at Boeing.\r\n\r\nVirgin Orbit focuses on small satellite launch, which is one of three capabilities being focused on by Virgin Galactic. These capabilities are: human spaceflight operations, small satellite launch, and advanced aerospace design, manufacturing, and test", "administrator": "President: Dan Hart", "founding_year": 2017, "launchers": "LauncherOne", "spacecraft": "", "parent": null, "image": { "id": 33, "name": "Virgin Orbit LauncherOne", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184714.jpeg", "credit": "Virgin Orbit", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 197, "name": "[AUTO] Virgin Orbit - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_logo_20200101102856.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185202.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 102, "name": "[AUTO] Virgin Orbit - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_nation_20200101103026.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184859.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://virginorbit.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Orbit", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1760, "name": "[AUTO] LauncherOne - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/launcherone_image_20200101110016.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193706.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/LauncherOne", "description": "LauncherOne is a two stage orbital launch vehicle developed by Virgin Orbit since 2007. It is an air launch to orbit rocket, designed to launch \"smallsat\" payloads of 300 kilograms (660 lb) into a Sun-synchronous orbit, following air launch from a carrier aircraft at high altitude.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 16.0, "diameter": 1.6, "maiden_flight": "2020-05-25", "launch_cost": 12000000, "launch_mass": 30.0, "leo_capacity": 500.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 300.0, "to_thrust": 327.0, "apogee": null, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P163DT19H8M9S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5884, "name": "Above the Clouds", "type": "Communications", "description": "Mission to a 500 km circular orbit inclined at 45 degrees carrying eight R&D satellites from US government agencies with communications and navigation experiments as well as two Earth-observation nanosatellites from Polish company SatRevolution.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 53, "url": "https://ll.thespacedevs.com/2.3.0/pads/53/?format=api", "active": true, "agencies": [], "name": "Mojave Air and Space Port", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Mojave_Air_and_Space_Port", "map_url": "https://www.google.com/maps?q=35.059444,-118.151667", "latitude": 35.059444, "longitude": -118.151667, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_53_20200803143612.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P163DT19H8M9S", "location": { "response_mode": "normal", "id": 20, "url": "https://ll.thespacedevs.com/2.3.0/locations/20/?format=api", "name": "Air launch to orbit", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7148, "successful_launches": 6605, "failed_launches": 543, "total_attempted_landings": 1102, "successful_landings": 1059, "failed_landings": 43 }, "active": true, "country": { "id": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 33, "name": "Virgin Orbit LauncherOne", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184714.jpeg", "credit": "Virgin Orbit", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_20_20200803142433.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 51, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6185, "location_launch_attempt_count": 49, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 3, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [ { "id": 1154, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://twitter.com/virginorbit/status/1481776527553404931?s=21", "created_by": "Cosmic_Penguin", "created_on": "2022-01-13T23:57:33Z" }, { "id": 1152, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Updating the window", "info_url": "https://twitter.com/VirginOrbit/status/1481662977547792384", "created_by": "SwGustav", "created_on": "2022-01-13T16:37:51Z" }, { "id": 1149, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Now targeting January 13.", "info_url": "https://twitter.com/VirginOrbit/status/1481043526221803532", "created_by": "Jay", "created_on": "2022-01-11T23:33:28Z" }, { "id": 1126, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch time.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=55184.msg2325756#msg2325756", "created_by": "Cosmic_Penguin", "created_on": "2021-12-29T00:37:09Z" }, { "id": 1107, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "NET January 12", "info_url": "https://twitter.com/virginorbit/status/1474125719496060928", "created_by": "Jay", "created_on": "2021-12-23T21:23:25Z" }, { "id": 1093, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch now planned in January 2022.", "info_url": "https://twitter.com/jeff_foust/status/1472992512981807105", "created_by": "Cosmic_Penguin", "created_on": "2021-12-21T01:17:51Z" }, { "id": 1059, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date/time per marine space closure notices, to be officially confirmed.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=55184.msg2319342#msg2319342", "created_by": "Cosmic_Penguin", "created_on": "2021-12-09T15:07:08Z" }, { "id": 1029, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Mentioning of this launch in USCG local warning messages has been removed.", "info_url": "https://www.navcen.uscg.gov/pdf/lnms/lnm11472021.pdf", "created_by": "Cosmic_Penguin", "created_on": "2021-11-30T17:51:40Z" }, { "id": 966, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch date and window updated per USCG marine space closure notices.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=55184.msg2309117#msg2309117", "created_by": "Cosmic_Penguin", "created_on": "2021-11-11T03:18:48Z" }, { "id": 958, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New mission name “Above The Clouds” confirmed.", "info_url": "https://virginorbit.com/the-latest/introducing-our-next-mission-above-the-clouds/", "created_by": "Cosmic_Penguin", "created_on": "2021-11-09T14:06:43Z" } ], "info_urls": [ { "priority": 9, "source": null, "title": "Above the Clouds", "description": "The U.S. Department of Defense is launching several Research and Development (R&D) satellites from multiple government agencies that are experiments in space-based communications and in-space navigation, as well as a university payload sponsored by NASA. This launch, also known as STP-27VPB, was awa...", "feature_image": null, "url": "https://virginorbit.com/above-the-clouds/", "type": null, "language": null }, { "priority": 10, "source": null, "title": "Introducing Our Next Mission: Above the Clouds", "description": "Coming off successful back-to-back launches, the Virgin Orbit team has settled into a steady flight preparation rhythm with LauncherOne. The fully assembled rocket that will carry our next customers’ satellites to space arrived early Monday morning at the Mojave Air and Space Port that serves as all...", "feature_image": null, "url": "https://virginorbit.com/the-latest/introducing-our-next-mission-above-the-clouds/", "type": null, "language": null } ], "vid_urls": [ { "priority": 9, "source": null, "publisher": null, "title": "LauncherOne Above The Clouds", "description": "LauncherOne Above The Clouds with initial coverage and post coverage cutThumbnail Photo Credit: Virgin Orbit", "feature_image": "https://i.ytimg.com/vi/g-sSo_iu1Rk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=g-sSo_iu1Rk", "type": null, "language": null, "start_time": null, "end_time": null, "live": false }, { "priority": 10, "source": null, "publisher": null, "title": "Above the Clouds Live Stream | Virgin Orbit", "description": "In our third commercial launch, Virgin Orbit is pleased to provide livestream coverage of pre-flight operations and launch commentary throughout the day. Joi...", "feature_image": "https://i.ytimg.com/vi/IEUQksTzGy8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=IEUQksTzGy8", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P197DT8H5M", "mission_patches": [ { "id": 591, "name": "Above The Clouds Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/above2520the2_mission_patch_20211109141957.png", "agency": { "response_mode": "list", "id": 199, "url": "https://ll.thespacedevs.com/2.3.0/agencies/199/?format=api", "name": "Virgin Orbit", "abbrev": "VO", "type": { "id": 3, "name": "Commercial" } }, "response_mode": "normal" } ] }
