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/e521d1a4-7f67-4a13-aaaa-c8faec0e824c/?format=api
{ "id": "e521d1a4-7f67-4a13-aaaa-c8faec0e824c", "url": "https://ll.thespacedevs.com/2.3.0/launches/e521d1a4-7f67-4a13-aaaa-c8faec0e824c/?format=api", "name": "LauncherOne | Straight Up", "response_mode": "detailed", "slug": "launcherone-straight-up", "launch_designator": "2022-074", "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:37Z", "net": "2022-07-02T06:53:00Z", "net_precision": null, "window_end": "2022-07-02T09:00:00Z", "window_start": "2022-07-02T05:00: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": null, "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": 7574, "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": 6017, "name": "Straight Up", "type": "Government/Top Secret", "description": "Launch contracted by the U.S. Space Force for the Rocket Systems Launch Program (RSLP), with payloads provided by the DoD Space Test Program (STP) as part of the Space Force’s STP-28A mission.\r\nIt will carry seven satellites from multiple government agencies that are experiments intended to demonstrate novel modular satellite bus, space domain awareness, and adaptive radio frequency technologies. The target orbit is approximately 500 km above the Earth’s surface at 45 degrees inclination.", "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": 7161, "successful_launches": 6618, "failed_launches": 543, "total_attempted_landings": 1110, "successful_landings": 1067, "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": 6259, "location_launch_attempt_count": 50, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 77, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "flightclub_url": null, "updates": [ { "id": 2022, "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/1543140101726814211?s=20&t=yUmBIgD0mGmhfh4U8JnyzQ", "created_by": "Cosmic_Penguin", "created_on": "2022-07-02T07:55:05Z" }, { "id": 2021, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Release, 1st stage ignition", "info_url": "https://youtu.be/O662GsLrdhc", "created_by": "Cosmic_Penguin", "created_on": "2022-07-02T06:54:11Z" }, { "id": 2019, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Take-off ~05:40 UTC -> Drop-off ~06:40 UTC", "info_url": "https://twitter.com/VirginOrbit/status/1543099739100815360?s=20&t=nIVLimsbbp3k_zPYDigQBg", "created_by": "Cosmic_Penguin", "created_on": "2022-07-02T05:18:04Z" }, { "id": 2010, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Setting GO", "info_url": "https://twitter.com/VirginOrbit/status/1542954958592659471", "created_by": "SwGustav", "created_on": "2022-07-01T19:38:15Z" }, { "id": 1998, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Scrubbed due to propellant temperature issues", "info_url": "https://twitter.com/virginorbit/status/1542363676149133312?s=21&t=Ufm1ODr6Gj3eFxIciI-s5g", "created_by": "Cosmic_Penguin", "created_on": "2022-06-30T04:33:13Z" }, { "id": 1995, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Pushing T-0 to account for takeoff and climb", "info_url": "https://spacenews.com/virgin-orbit-ready-for-first-night-launch/", "created_by": "Nosu", "created_on": "2022-06-29T21:02:42Z" }, { "id": 1981, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "GO for launch", "info_url": "https://virginorbit.com/the-latest/virgin-orbit-on-target-for-next-launch-window-to-open-june-29/", "created_by": "Nosu", "created_on": "2022-06-27T08:36:12Z" }, { "id": 1841, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch window", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=56332.msg2373887#msg2373887", "created_by": "Nosu", "created_on": "2022-06-09T07:22:56Z" }, { "id": 1658, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET June 30 UTC", "info_url": "https://investors.virginorbit.com/news-events/press-releases/detail/36/virgin-orbit-announces-next-launch-dubbed-straight-up", "created_by": "Nosu", "created_on": "2022-05-09T14:52:54Z" } ], "info_urls": [ { "priority": 10, "source": null, "title": "VIRGIN ORBIT ANNOUNCES NEXT LAUNCH, DUBBED ‘STRAIGHT UP’", "description": "LauncherOne has arrived in Mojave Air and Space Port in preparation for upcoming launch.\n\nLONG BEACH, CA — MAY 09, 2022 — Virgin Orbit (Nasdaq: VORB) has entered flight preparation mode for its forthcoming launch, Straight Up, that will support the United States Space Force’s STP-28A mission. After ...", "feature_image": null, "url": "https://virginorbit.com/the-latest/virgin-orbit-announces-next-launch-dubbed-straight-up/", "type": null, "language": null } ], "vid_urls": [ { "priority": 10, "source": null, "publisher": null, "title": "Virgin Orbit’s Straight Up Mission", "description": "In our fourth commercial launch, Virgin Orbit is pleased to provide livestream coverage of pre-flight operations and launch commentary throughout the day. Jo...", "feature_image": "https://i.ytimg.com/vi/O662GsLrdhc/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=O662GsLrdhc", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P169DT8H1M", "mission_patches": [ { "id": 633, "name": "Straight Up Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/straight2520up_mission_patch_20220530195431.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" } ] }
