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/ccd1a7bc-8506-40c3-8967-9ce168084c2c/?format=api
{ "id": "ccd1a7bc-8506-40c3-8967-9ce168084c2c", "url": "https://ll.thespacedevs.com/2.2.0/launch/ccd1a7bc-8506-40c3-8967-9ce168084c2c/?format=api", "slug": "new-shepard-ns-29", "flightclub_url": null, "r_spacex_api_id": null, "name": "New Shepard | NS-29", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-02-04T17:16:06Z", "updates": [ { "id": 10004, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Mission complete.", "info_url": "https://www.youtube.com/watch?v=l65LQcL2jUU", "created_by": "Cosmic_Penguin", "created_on": "2025-02-04T16:13:00Z" }, { "id": 10003, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=l65LQcL2jUU", "created_by": "Cosmic_Penguin", "created_on": "2025-02-04T16:01:00Z" }, { "id": 10002, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by Blue Origin has started", "info_url": "https://www.youtube.com/watch?v=l65LQcL2jUU", "created_by": "LL2", "created_on": "2025-02-04T15:50:00Z" }, { "id": 9989, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://x.com/blueorigin/status/1886435233014161430", "created_by": "Cosmic_Penguin", "created_on": "2025-02-03T15:25:00Z" }, { "id": 9957, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET February 4.", "info_url": "https://www.fly.faa.gov/adv/adv_spt.jsp", "created_by": "Cosmic_Penguin", "created_on": "2025-01-30T09:36:00Z" }, { "id": 9942, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Now targeting Jan 30 at 15:30 UTC", "info_url": "https://www.fly.faa.gov/adv/adv_spt.jsp", "created_by": "hitura-nobad", "created_on": "2025-01-28T21:08:00Z" }, { "id": 9940, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Scrubbed for the day.", "info_url": "https://x.com/blueorigin/status/1884300119706931531", "created_by": "Cosmic_Penguin", "created_on": "2025-01-28T17:59:00Z" }, { "id": 9939, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Holding at T-10 minutes.", "info_url": "https://www.youtube.com/watch?v=KGnmQJ9xqVo", "created_by": "Cosmic_Penguin", "created_on": "2025-01-28T16:26:00Z" }, { "id": 9938, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by Blue Origin has started", "info_url": "https://www.youtube.com/watch?v=KGnmQJ9xqVo", "created_by": "LL2", "created_on": "2025-01-28T15:51:00Z" }, { "id": 9937, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked NET T-0.", "info_url": "https://x.com/blueorigin/status/1883972019001172330", "created_by": "Cosmic_Penguin", "created_on": "2025-01-28T15:39:00Z" }, { "id": 9880, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://www.blueorigin.com/news/new-shepard-ns-29-mission", "created_by": "Cosmic_Penguin", "created_on": "2025-01-24T17:33:00Z" }, { "id": 9876, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=44473.msg2659216#msg2659216", "created_by": "Cosmic_Penguin", "created_on": "2025-01-24T09:43:00Z" } ], "net": "2025-02-04T16:00:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-02-04T23:30:00Z", "window_start": "2025-02-04T15:30:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 31, "consecutive_successful_launches": 8, "successful_launches": 30, "failed_launches": 1, "pending_launches": 5, "consecutive_successful_landings": 2, "successful_landings": 28, "failed_landings": 3, "attempted_landings": 31, "info_url": "http://www.blueorigin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" }, "rocket": { "id": 8472, "configuration": { "id": 137, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/137/?format=api", "name": "New Shepard", "active": true, "reusable": true, "description": "The New Shepard reusable launch system is a vertical-takeoff, vertical-landing (VTVL), suborbital manned rocket that is being developed by Blue Origin as a commercial system for suborbital space tourism.", "family": "", "full_name": "New Shepard", "manufacturer": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 31, "consecutive_successful_launches": 8, "successful_launches": 30, "failed_launches": 1, "pending_launches": 5, "consecutive_successful_landings": 2, "successful_landings": 28, "failed_landings": 3, "attempted_landings": 31, "info_url": "http://www.blueorigin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 15.0, "diameter": 3.7, "maiden_flight": "2015-04-29", "launch_cost": null, "launch_mass": 75, "leo_capacity": 0, "gto_capacity": 0, "to_thrust": 490, "apogee": 100, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new2520shepard_image_20190207032624.jpeg", "info_url": "https://www.blueorigin.com/new-shepard/", "wiki_url": "https://en.wikipedia.org/wiki/New_Shepard", "total_launch_count": 30, "consecutive_successful_launches": 7, "successful_launches": 29, "failed_launches": 1, "pending_launches": 1, "attempted_landings": 30, "successful_landings": 28, "failed_landings": 2, "consecutive_successful_landings": 7 }, "launcher_stage": [ { "id": 653, "type": "Core", "reused": true, "launcher_flight_number": 2, "launcher": { "id": 187, "url": "https://ll.thespacedevs.com/2.2.0/launcher/187/?format=api", "details": "5th New Shepard booster.", "flight_proven": true, "serial_number": "NS-5", "status": "active", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns-5_on_the_lau_image_20250204174818.jpg", "successful_landings": 2, "attempted_landings": 2, "flights": 2, "last_launch_date": "2025-02-04T16:00:00Z", "first_launch_date": "2024-10-23T15:27:00Z" }, "landing": { "id": 1524, "attempt": true, "success": true, "description": "The New Shepard booster has landed back on the landing pad.", "downrange_distance": 3.2, "location": { "id": 11, "name": "Corn Ranch Landing Pad, West Texas", "abbrev": "CR", "description": "New Shepard landing site.", "location": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/location/29/?format=api", "name": "Corn Ranch, Van Horn, TX, USA", "country_code": "USA", "description": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg", "timezone_name": "America/Chicago", "total_launch_count": 30, "total_landing_count": 30 }, "successful_landings": 25 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": "2024-10-23T15:27:00Z", "turn_around_time_days": 104, "previous_flight": { "id": "828095e3-1c38-4700-9dd2-a700162fbd15", "name": "New Shepard | NS-27" } } ], "spacecraft_stage": { "id": 869, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/869/?format=api", "mission_end": "2025-02-04T16:10:06Z", "destination": "Suborbital", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 276, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/276/?format=api", "name": "RSS H.G. Wells", "serial_number": "2.0-1", "is_placeholder": false, "in_space": false, "time_in_space": "PT1H50M15S", "time_docked": "P0D", "flights_count": 11, "mission_ends_count": 11, "status": { "id": 1, "name": "Active" }, "description": "Second New Shepard capsule. It is dedicated to uncrewed flights.", "spacecraft_config": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/21/?format=api", "name": "Crew Capsule 2.0", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png" }, "in_use": true, "capability": "Crew and Cargo Flights", "history": "The Crew Capsule 2.0 is the newest version of Blue Origin's New Shepard rocket.", "details": "It is deisgned to spearate from the launcher stage below the Karman line and pursue a ballistic free flight above it before landing.", "maiden_flight": "2017-12-12", "height": null, "diameter": null, "human_rated": true, "crew_capacity": 6, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "The capsule is designed to be reusable.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/crew2520capsule25202.0_image_20190309095011.jpeg", "nation_url": null, "wiki_link": "", "info_link": "" } }, "landing": { "id": 1525, "attempt": true, "success": true, "description": "The RSS First Step capsule has landed back at Blue Origin's Corn Ranch facility.", "downrange_distance": null, "location": { "id": 28, "name": "Corn Ranch, West Texas", "abbrev": "CR", "description": "Blue Origin launch and landing facility located in West Texas", "location": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/location/29/?format=api", "name": "Corn Ranch, Van Horn, TX, USA", "country_code": "USA", "description": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg", "timezone_name": "America/Chicago", "total_launch_count": 30, "total_landing_count": 30 }, "successful_landings": 33 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 7061, "name": "NS-29", "description": "NS-29 will simulate the Moon’s gravity and fly 30 payloads, all but one of which is focused on testing lunar-related technologies.\r\n\r\nThe payloads will experience at least two minutes of lunar gravity forces, a first for New Shepard and made possible in part through support from NASA. The flight will test six broad lunar technology areas: In-situ resource utilization, dust mitigation, advanced habitation systems, sensors and instrumentation, small spacecraft technologies, and entry descent and landing. Proving out these technologies at lower cost is another step toward Blue Origin’s mission to lower the cost of access to space for the benefit of Earth. It also enables NASA and other lunar surface technology providers to test innovations critical to achieving Artemis program goals and exploring the Moon’s surface. \r\n\r\nThe New Shepard crew capsule is using its Reaction Control System (RCS) to spin up to approximately 11 revolutions per minute. This spin rate simulates one-sixth Earth gravity at the midpoint of the crew capsule lockers. In simulated lunar gravity, customers can accelerate their learning and technology readiness for lunar payloads at much lower cost.", "launch_designator": null, "type": "Suborbital", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [ { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 31, "consecutive_successful_launches": 8, "successful_launches": 30, "failed_launches": 1, "pending_launches": 5, "consecutive_successful_landings": 2, "successful_landings": 28, "failed_landings": 3, "attempted_landings": 31, "info_url": "http://www.blueorigin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 90, "url": "https://ll.thespacedevs.com/2.2.0/pad/90/?format=api", "agency_id": 141, "name": "West Texas Suborbital Launch Site/ Corn Ranch", "description": null, "info_url": "http://www.blueorigin.com", "wiki_url": "https://en.wikipedia.org/wiki/Corn_Ranch", "map_url": "https://www.google.com/maps?q=31.422878000000000,-104.757121000000000", "latitude": "31.422878", "longitude": "-104.757121", "location": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/location/29/?format=api", "name": "Corn Ranch, Van Horn, TX, USA", "country_code": "USA", "description": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg", "timezone_name": "America/Chicago", "total_launch_count": 30, "total_landing_count": 30 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_90_20200803143233.jpg", "total_launch_count": 30, "orbital_launch_attempt_count": 0 }, "infoURLs": [ { "priority": 10, "source": null, "title": null, "description": null, "feature_image": null, "url": "https://www.blueorigin.com/news/new-shepard-ns-29-mission", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "Blue Origin", "title": "Replay: New Shepard Mission NS-29 Webcast", "description": "Blue Origin successfully completed its 29th New Shepard flight and 14th payload mission on Tuesday, February 4, 2025 from Launch Site One in West Texas. The New Shepard crew capsule used its reaction ...", "feature_image": "https://i.ytimg.com/vi/l65LQcL2jUU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=l65LQcL2jUU", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2025-02-04T15:45:16Z", "end_time": "2025-02-04T16:15:09Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 29, "pad_launch_attempt_count": 29, "agency_launch_attempt_count": 30, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P74DT30M", "mission_patches": [], "type": "detailed" }
