API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch// 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'

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.0.0/launch/828095e3-1c38-4700-9dd2-a700162fbd15/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "828095e3-1c38-4700-9dd2-a700162fbd15",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/828095e3-1c38-4700-9dd2-a700162fbd15/?format=api",
    "launch_library_id": null,
    "slug": "new-shepard-ns-27",
    "name": "New Shepard | NS-27",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2024-10-23T15:27:00Z",
    "window_end": "2024-10-23T15:27:00Z",
    "window_start": "2024-10-23T15:27:00Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 141,
        "url": "https://ll.thespacedevs.com/2.0.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": 32,
        "consecutive_successful_launches": 9,
        "successful_launches": 31,
        "failed_launches": 1,
        "pending_launches": 4,
        "consecutive_successful_landings": 3,
        "successful_landings": 29,
        "failed_landings": 3,
        "attempted_landings": 32,
        "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": 8368,
        "configuration": {
            "id": 137,
            "launch_library_id": 9999,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/137/?format=api",
            "name": "New Shepard",
            "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.0.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": 32,
                "consecutive_successful_launches": 9,
                "successful_launches": 31,
                "failed_launches": 1,
                "pending_launches": 4,
                "consecutive_successful_landings": 3,
                "successful_landings": 29,
                "failed_landings": 3,
                "attempted_landings": 32,
                "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_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": 31,
            "consecutive_successful_launches": 8,
            "successful_launches": 30,
            "failed_launches": 1,
            "pending_launches": 0
        },
        "launcher_stage": [
            {
                "id": 600,
                "type": "Core",
                "reused": false,
                "launcher_flight_number": 1,
                "launcher": {
                    "id": 187,
                    "url": "https://ll.thespacedevs.com/2.0.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": 3,
                    "attempted_landings": 3,
                    "flights": 3,
                    "last_launch_date": "2025-04-14T13:30:00Z",
                    "first_launch_date": "2024-10-23T15:27:00Z"
                },
                "landing": {
                    "id": 1459,
                    "attempt": true,
                    "success": true,
                    "description": "NS-5 has landed back on the landing pad.",
                    "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.0.0/location/29/?format=api",
                            "name": "Corn Ranch, Van Horn, TX, USA",
                            "country_code": "USA",
                            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
                            "total_launch_count": 31,
                            "total_landing_count": 31
                        },
                        "successful_landings": 34
                    },
                    "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": null,
                "turn_around_time_days": null,
                "previous_flight": null
            }
        ],
        "spacecraft_stage": {
            "id": 860,
            "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/860/?format=api",
            "mission_end": "2024-10-23T15:37:00Z",
            "destination": "Suborbital",
            "launch_crew": [],
            "onboard_crew": [],
            "landing_crew": [],
            "spacecraft": {
                "id": 599,
                "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/599/?format=api",
                "name": "RSS Kármán line",
                "serial_number": null,
                "status": {
                    "id": 1,
                    "name": "Active"
                },
                "description": "Second human rated Crew Capsule for New Shepard.",
                "spacecraft_config": {
                    "id": 21,
                    "url": "https://ll.thespacedevs.com/2.0.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.0.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"
                    },
                    "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,
                    "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": ""
                }
            },
            "docking_events": []
        }
    },
    "mission": {
        "id": 6949,
        "launch_library_id": null,
        "name": "NS-27",
        "description": "Twenty-seventh flight of New Shepard, flying without crew as a test for the newest booster.",
        "launch_designator": null,
        "type": "Suborbital",
        "orbit": {
            "id": 15,
            "name": "Suborbital",
            "abbrev": "Sub"
        }
    },
    "pad": {
        "id": 90,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/90/?format=api",
        "agency_id": 141,
        "name": "West Texas Suborbital Launch Site/ Corn Ranch",
        "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.0.0/location/29/?format=api",
            "name": "Corn Ranch, Van Horn, TX, USA",
            "country_code": "USA",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
            "total_launch_count": 31,
            "total_landing_count": 31
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_90_20200803143233.jpg",
        "total_launch_count": 31
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 10,
            "title": "Replay: New Shepard Mission NS-27 Webcast",
            "description": "On October 23, 2024 Blue Origin’s 27th mission debuted the second human-rated vehicle for the New Shepard program to expand capacity and meet growing customer demand. The uncrewed verification flight ...",
            "feature_image": "https://i.ytimg.com/vi/5Gmm_VxxMsA/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=5Gmm_VxxMsA"
        }
    ],
    "webcast_live": false,
    "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": 27,
    "pad_launch_attempt_count": 27,
    "agency_launch_attempt_count": 27,
    "orbital_launch_attempt_count_year": 0,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 3,
    "agency_launch_attempt_count_year": 3
}