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/d4a6a953-d1b2-4f68-b891-b9c75fc96ff2/?format=api
{ "id": "d4a6a953-d1b2-4f68-b891-b9c75fc96ff2", "url": "https://ll.thespacedevs.com/2.2.0/launch/d4a6a953-d1b2-4f68-b891-b9c75fc96ff2/?format=api", "slug": "new-shepard-ns-23", "flightclub_url": null, "r_spacex_api_id": null, "name": "New Shepard | NS-23", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T09:48:32Z", "updates": [ { "id": 2383, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch abort at T+1:05", "info_url": "https://twitter.com/blueorigin/status/1569335094195929091?s=20&t=Uk_J43gAWN4r32AzZGsTyw", "created_by": "Cosmic_Penguin", "created_on": "2022-09-12T14:48:28Z" }, { "id": 2382, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff", "info_url": "https://youtu.be/SqAVWvOT-1c", "created_by": "Cosmic_Penguin", "created_on": "2022-09-12T14:27:05Z" }, { "id": 2381, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Webcast live", "info_url": "https://youtu.be/SqAVWvOT-1c", "created_by": "Cosmic_Penguin", "created_on": "2022-09-12T13:07:47Z" }, { "id": 2346, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding new launch window and setting GO", "info_url": "https://twitter.com/blueorigin/status/1567537926409719809", "created_by": "Nosu", "created_on": "2022-09-07T15:40:23Z" }, { "id": 2329, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "No launch on September 3rd.", "info_url": "https://twitter.com/SpaceTfrs/status/1565719526246940674?s=20&t=8tTW3rGaxg0qGSFHyhEjYQ", "created_by": "Cosmic_Penguin", "created_on": "2022-09-03T04:10:54Z" }, { "id": 2322, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Scrubbed again due to weather", "info_url": "https://twitter.com/blueorigin/status/1565542213412884480", "created_by": "Nosu", "created_on": "2022-09-02T05:23:06Z" }, { "id": 2319, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Update start of window", "info_url": "https://twitter.com/blueorigin/status/1565352600748556290?s=20&t=kt38forKosDXTxBYkfhgtQ", "created_by": "Cosmic_Penguin", "created_on": "2022-09-01T15:11:48Z" }, { "id": 2316, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Delayed by 24 hours", "info_url": "https://www.youtube.com/watch?v=SqAVWvOT-1c", "created_by": "Nosu", "created_on": "2022-09-01T12:28:14Z" }, { "id": 2308, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Updating NET", "info_url": "https://twitter.com/blueorigin/status/1565010999933284353", "created_by": "SwGustav", "created_on": "2022-08-31T16:22:34Z" }, { "id": 2307, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Scrub due to weather", "info_url": "https://twitter.com/blueorigin/status/1564945454487728128", "created_by": "SwGustav", "created_on": "2022-08-31T12:00:01Z" }, { "id": 2277, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch window", "info_url": "https://www.blueorigin.com/news/new-shepard-ns-23-mission-announcement/", "created_by": "Nosu", "created_on": "2022-08-24T17:18:57Z" }, { "id": 2276, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET August 31", "info_url": "https://twitter.com/blueorigin/status/1562478768098226177", "created_by": "Nosu", "created_on": "2022-08-24T17:06:31Z" } ], "net": "2022-09-12T14:27:00Z", "net_precision": null, "window_end": "2022-09-12T16:00:00Z", "window_start": "2022-09-12T13:30:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Launch escape system activated at T+1:05 following apparent BE-3 booster engine shutdown; capsule landed nominally", "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": 7632, "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": 275, "type": "Core", "reused": true, "launcher_flight_number": 9, "launcher": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/launcher/63/?format=api", "details": "New Shepard vehicle #3 was the third flight vehicle of the New Shepard suborbital rocket. It suffered an anomaly during its ninth flight.", "flight_proven": true, "serial_number": "NS-3", "status": "destroyed", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/63_image_20190225165029.jpeg", "successful_landings": 8, "attempted_landings": 9, "flights": 9, "last_launch_date": "2022-09-12T14:27:00Z", "first_launch_date": "2017-12-12T16:59:00Z" }, "landing": { "id": 303, "attempt": true, "success": false, "description": "NS3 suffered an anomaly during its ninth flight.", "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": "2021-08-26T14:31:00Z", "turn_around_time_days": 381, "previous_flight": { "id": "ff3ef28b-afd5-414f-aab4-040d5b74fdd6", "name": "New Shepard | NS-17" } } ], "spacecraft_stage": { "id": 786, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/786/?format=api", "mission_end": "2022-09-12T14:32:36Z", "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": 690, "attempt": true, "success": true, "description": "The RSS H.G. Wells capsule successfully touched down 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": 6133, "name": "NS-23", "description": "Twenty-third flight of New Shepard carrying 36 science and research payloads along with tens of thousands of postcards from Club For Future.", "launch_designator": null, "type": "Suborbital", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "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": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "New Shepard Mission NS-23 Webcast", "description": "New Shepard’s 23rd mission, a dedicated payloads flight, will fly 36 payloads from academia, research institutions, and students across the globe. The launch...", "feature_image": "https://i.ytimg.com/vi/SqAVWvOT-1c/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=SqAVWvOT-1c", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new2520shepard_image_20190207032624.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 23, "pad_launch_attempt_count": 23, "agency_launch_attempt_count": 23, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P39DT30M53S", "mission_patches": [], "type": "detailed" }
