GET

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/1b11f81e-cdbf-49aa-a7ce-aa79f609046c/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "1b11f81e-cdbf-49aa-a7ce-aa79f609046c",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/1b11f81e-cdbf-49aa-a7ce-aa79f609046c/?format=api",
    "slug": "orbex-prime-maiden-flight",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Orbex Prime | Maiden Flight",
    "status": {
        "id": 2,
        "name": "To Be Determined",
        "abbrev": "TBD",
        "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
    },
    "last_updated": "2024-12-27T07:52:37Z",
    "updates": [
        {
            "id": 9645,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Updated launch site",
            "info_url": "https://spacenews.com/orbex-halts-work-on-own-spaceport-shifts-launches-to-saxavord/",
            "created_by": "Nosu",
            "created_on": "2024-12-27T07:52:00Z"
        },
        {
            "id": 8348,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "NET 2025",
            "info_url": "https://spacenews.com/orbex-working-towards-2025-first-launch/",
            "created_by": "Nosu",
            "created_on": "2024-08-19T06:51:31Z"
        },
        {
            "id": 2642,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "NET 2023",
            "info_url": "https://spacenews.com/orbex-raises-series-c-round/",
            "created_by": "Jay",
            "created_on": "2022-10-18T12:22:16Z"
        },
        {
            "id": 1668,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Added launch 2022 TBD",
            "info_url": null,
            "created_by": "Jay",
            "created_on": "2022-05-11T18:24:22Z"
        }
    ],
    "net": "2025-12-31T00:00:00Z",
    "net_precision": {
        "id": 14,
        "name": "Year",
        "abbrev": "Y",
        "description": "The T-0 is expected in the given year."
    },
    "window_end": "2025-12-31T00:00:00Z",
    "window_start": "2025-12-31T00:00:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 1033,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/1033/?format=api",
        "name": "Orbex",
        "featured": false,
        "type": "Commercial",
        "country_code": "GBR",
        "abbrev": "Orbex",
        "description": "Orbex is an aerospace company based in Scotland providing CubeSat launches to low Earth orbits.",
        "administrator": "CEO: Martin Coates",
        "founding_year": "2015",
        "launchers": "Orbex Prime",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 0,
        "consecutive_successful_launches": 0,
        "successful_launches": 0,
        "failed_launches": 0,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://orbex.space",
        "wiki_url": "https://en.wikipedia.org/wiki/Orbex",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_logo_20220511124742.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_image_20220511124742.jpg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_nation_20220511124743.jpg"
    },
    "rocket": {
        "id": 7575,
        "configuration": {
            "id": 480,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/480/?format=api",
            "name": "Prime",
            "active": false,
            "reusable": false,
            "description": "Prime is a 2 stage orbital launch vehicle manufactured and operated by Orbex to provide launches for small satellites to low Earth orbits.",
            "family": "",
            "full_name": "Orbex Prime",
            "manufacturer": {
                "id": 1033,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1033/?format=api",
                "name": "Orbex",
                "featured": false,
                "type": "Commercial",
                "country_code": "GBR",
                "abbrev": "Orbex",
                "description": "Orbex is an aerospace company based in Scotland providing CubeSat launches to low Earth orbits.",
                "administrator": "CEO: Martin Coates",
                "founding_year": "2015",
                "launchers": "Orbex Prime",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://orbex.space",
                "wiki_url": "https://en.wikipedia.org/wiki/Orbex",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_logo_20220511124742.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_image_20220511124742.jpg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_nation_20220511124743.jpg"
            },
            "program": [],
            "variant": "Prime",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": 19.0,
            "diameter": 1.3,
            "maiden_flight": null,
            "launch_cost": null,
            "launch_mass": 18,
            "leo_capacity": null,
            "gto_capacity": null,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/prime_image_20220511125637.jpg",
            "info_url": "https://orbex.space/vehicle",
            "wiki_url": "https://en.wikipedia.org/wiki/Orbex#Prime",
            "total_launch_count": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 1,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6018,
        "name": "Maiden Flight",
        "description": "Maiden flight of Orbex's Prime rocket from Sutherland Spaceport. This flights marks the first vertical orbital launch attempt from the United Kingdom, and the first orbital launch attempt from Scotland.",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 25,
            "name": "Unknown",
            "abbrev": "N/A"
        },
        "agencies": [
            {
                "id": 1033,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1033/?format=api",
                "name": "Orbex",
                "featured": false,
                "type": "Commercial",
                "country_code": "GBR",
                "abbrev": "Orbex",
                "description": "Orbex is an aerospace company based in Scotland providing CubeSat launches to low Earth orbits.",
                "administrator": "CEO: Martin Coates",
                "founding_year": "2015",
                "launchers": "Orbex Prime",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://orbex.space",
                "wiki_url": "https://en.wikipedia.org/wiki/Orbex",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_logo_20220511124742.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_image_20220511124742.jpg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbex_nation_20220511124743.jpg"
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 237,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/237/?format=api",
        "agency_id": null,
        "name": "Unknown Pad",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/SaxaVord_Spaceport",
        "map_url": "https://www.google.com/maps?q=60.8184,-0.7692",
        "latitude": "60.8184",
        "longitude": "-0.7692",
        "location": {
            "id": 157,
            "url": "https://ll.thespacedevs.com/2.2.0/location/157/?format=api",
            "name": "SaxaVord Spaceport",
            "country_code": "GBR",
            "description": "SaxaVord Spaceport is a UK spaceport located on the Lamba Ness peninsula on Unst, the most northerly of the inhabited Shetland Islands off the coast of Scotland. The site is near the RAF Saxa Vord radar station and the settlement of Skaw, adjacent to the Saxa Vord distillery.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_saxavord_spaceport_20211102161146.jpg",
            "timezone_name": "Europe/London",
            "total_launch_count": 0,
            "total_landing_count": 0
        },
        "country_code": "GBR",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_unknown_pad_20241227075133.jpg",
        "total_launch_count": 0,
        "orbital_launch_attempt_count": 0
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/prime_image_20220511125637.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7125,
    "location_launch_attempt_count": 3,
    "pad_launch_attempt_count": 1,
    "agency_launch_attempt_count": 1,
    "orbital_launch_attempt_count_year": 276,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P0D",
    "mission_patches": [],
    "type": "detailed"
}