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

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/b8f2e028-285c-457d-b807-a6749cfc3af6/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "b8f2e028-285c-457d-b807-a6749cfc3af6",
    "url": "https://ll.thespacedevs.com/2.3.0/launches/b8f2e028-285c-457d-b807-a6749cfc3af6/?format=api",
    "name": "Firefly Alpha | FLTA003 (VICTUS NOX)",
    "response_mode": "detailed",
    "slug": "firefly-alpha-flta003-victus-nox",
    "launch_designator": "2023-142",
    "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
    },
    "last_updated": "2024-03-05T18:10:43Z",
    "net": "2023-09-15T02:28:00Z",
    "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "window_end": "2023-09-15T03:19:00Z",
    "window_start": "2023-09-15T01:57:00Z",
    "image": {
        "id": 1489,
        "name": "[AUTO] Firefly Alpha | FLTA003 (VICTUS NOX) - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly2520alp_image_20230915073405.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192928.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": 265,
        "url": "https://ll.thespacedevs.com/2.3.0/agencies/265/?format=api",
        "name": "Firefly Aerospace",
        "abbrev": "FA",
        "type": {
            "id": 3,
            "name": "Commercial"
        },
        "featured": true,
        "country": [
            {
                "id": 2,
                "name": "United States of America",
                "alpha_2_code": "US",
                "alpha_3_code": "USA",
                "nationality_name": "American",
                "nationality_name_composed": "Americano"
            }
        ],
        "description": "Firefly Aerospace is an American private aerospace firm based in Austin, Texas, that develops small and medium-sized launch vehicles for commercial launches to orbit.",
        "administrator": "CEO: Peter Schumacher",
        "founding_year": 2014,
        "launchers": "",
        "spacecraft": "",
        "parent": null,
        "image": null,
        "logo": {
            "id": 134,
            "name": "[AUTO] Firefly Aerospace - logo",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly2520aerospace_logo_20220826094423.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184955.jpeg",
            "credit": null,
            "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
            },
            "single_use": true,
            "variants": []
        },
        "social_logo": {
            "id": 58,
            "name": "[AUTO] Firefly Aerospace - social_logo",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly2520aerospace_nation_20230531050520.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184757.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": 3,
        "failed_launches": 3,
        "pending_launches": 4,
        "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": 1,
        "failed_landings_payload": 0,
        "attempted_landings_payload": 1,
        "info_url": "https://firefly.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Firefly_Aerospace",
        "social_media_links": []
    },
    "rocket": {
        "id": 7758,
        "configuration": {
            "response_mode": "detailed",
            "id": 179,
            "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/179/?format=api",
            "name": "Firefly Alpha",
            "families": [],
            "full_name": "Firefly Alpha",
            "variant": "",
            "active": true,
            "is_placeholder": false,
            "manufacturer": {
                "response_mode": "normal",
                "id": 265,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/265/?format=api",
                "name": "Firefly Aerospace",
                "abbrev": "FA",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                },
                "featured": true,
                "country": [
                    {
                        "id": 2,
                        "name": "United States of America",
                        "alpha_2_code": "US",
                        "alpha_3_code": "USA",
                        "nationality_name": "American",
                        "nationality_name_composed": "Americano"
                    }
                ],
                "description": "Firefly Aerospace is an American private aerospace firm based in Austin, Texas, that develops small and medium-sized launch vehicles for commercial launches to orbit.",
                "administrator": "CEO: Peter Schumacher",
                "founding_year": 2014,
                "launchers": "",
                "spacecraft": "",
                "parent": null,
                "image": null,
                "logo": {
                    "id": 134,
                    "name": "[AUTO] Firefly Aerospace - logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly2520aerospace_logo_20220826094423.jpg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184955.jpeg",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                },
                "social_logo": {
                    "id": 58,
                    "name": "[AUTO] Firefly Aerospace - social_logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly2520aerospace_nation_20230531050520.jpg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184757.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": 3,
                "failed_launches": 3,
                "pending_launches": 4,
                "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": 1,
                "failed_landings_payload": 0,
                "attempted_landings_payload": 1,
                "info_url": "https://firefly.com/",
                "wiki_url": "https://en.wikipedia.org/wiki/Firefly_Aerospace",
                "social_media_links": []
            },
            "program": [],
            "reusable": false,
            "image": {
                "id": 1740,
                "name": "Firefly Alpha liftoff (FLTA004)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly_alpha_l_image_20240605174156.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/firefly_alpha_l_image_thumbnail_20240605174157.jpeg",
                "credit": "Firefly Aerospace / Jack Beyer",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "info_url": "https://fireflyspace.com/alpha/",
            "wiki_url": "https://en.wikipedia.org/wiki/Firefly_Alpha",
            "description": "Firefly Alpha (Firefly α) is a two-stage orbital expendable launch vehicle developed by the American aerospace company Firefly Aerospace to cover the commercial small satellite launch market. Alpha is intended to provide launch options for both full vehicle and ride share customers.",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": 29.0,
            "diameter": 1.82,
            "maiden_flight": "2021-09-03",
            "launch_cost": 15000000,
            "launch_mass": 54.0,
            "leo_capacity": 1000.0,
            "gto_capacity": null,
            "geo_capacity": null,
            "sso_capacity": 630.0,
            "to_thrust": 736.0,
            "apogee": null,
            "total_launch_count": 6,
            "consecutive_successful_launches": 0,
            "successful_launches": 3,
            "failed_launches": 3,
            "pending_launches": 4,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0,
            "fastest_turnaround": "P98DT15H4M30S"
        },
        "launcher_stage": [],
        "spacecraft_stage": [],
        "payloads": []
    },
    "mission": {
        "id": 6274,
        "name": "FLTA003 (VICTUS NOX)",
        "type": "Government/Top Secret",
        "description": "Third flight of the Firefly Alpha small sat launcher, carrying a payload for the US Department of Defense.",
        "image": null,
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO",
            "celestial_body": {
                "response_mode": "list",
                "id": 1,
                "name": "Earth"
            }
        },
        "agencies": [
            {
                "response_mode": "normal",
                "id": 1041,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/1041/?format=api",
                "name": "United States Space Force",
                "abbrev": "USSF",
                "type": {
                    "id": 1,
                    "name": "Government"
                },
                "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": "The United States Space Force (USSF) is the space service branch of the U.S. Armed Forces, one of the eight U.S. uniformed services.",
                "administrator": null,
                "founding_year": 2019,
                "launchers": "",
                "spacecraft": "",
                "parent": null,
                "image": null,
                "logo": {
                    "id": 194,
                    "name": "[AUTO] United States Space Force - logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520space2520force_logo_20221102113048.png",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185155.png",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                },
                "social_logo": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "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://www.spaceforce.mil/",
                "wiki_url": "https://en.wikipedia.org/wiki/United_States_Space_Force",
                "social_media_links": []
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 39,
        "url": "https://ll.thespacedevs.com/2.3.0/pads/39/?format=api",
        "active": true,
        "agencies": [],
        "name": "Space Launch Complex 2W",
        "image": {
            "id": 2248,
            "name": "Delta II 7920-10 liftoff from SLC-2W (NROL-21)",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_ii_7920-1_image_20240922115616.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_ii_7920-1_image_thumbnail_20240922115616.jpeg",
            "credit": "USAF/Michael Stonecypher",
            "license": {
                "id": 17,
                "name": "Department of Defense Image Use Policy",
                "priority": 6,
                "link": "https://www.dimoc.mil/resources/limitations/"
            },
            "single_use": false,
            "variants": []
        },
        "description": "SLC-2W was originally used for Delta, Thor-Agena and Delta II launches. After the last Delta II flight in 2018, SLC-2W was repurposed to launch Firefly Alpha rockets.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_2",
        "map_url": "https://www.google.com/maps?q=34.7556,-120.6224",
        "latitude": 34.7556,
        "longitude": -120.6224,
        "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_39_20200803143542.jpg",
        "total_launch_count": 98,
        "orbital_launch_attempt_count": 98,
        "fastest_turnaround": "P26DT16H39M49S",
        "location": {
            "response_mode": "normal",
            "id": 11,
            "url": "https://ll.thespacedevs.com/2.3.0/locations/11/?format=api",
            "name": "Vandenberg SFB, CA, USA",
            "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": 7150,
                "successful_launches": 6607,
                "failed_launches": 543,
                "total_attempted_landings": 1104,
                "successful_landings": 1061,
                "failed_landings": 43
            },
            "active": true,
            "country": {
                "id": 2,
                "name": "United States of America",
                "alpha_2_code": "US",
                "alpha_3_code": "USA",
                "nationality_name": "American",
                "nationality_name_composed": "Americano"
            },
            "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.",
            "image": {
                "id": 2226,
                "name": "Vandenberg SFB imaged by Sentinel-2",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_20240920082910.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_thumbnail_20240920082910.jpeg",
                "credit": "Contains modified Copernicus Sentinel data 2020",
                "license": {
                    "id": 33,
                    "name": "Copernicus Image Use Policy",
                    "priority": 0,
                    "link": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32013R1159"
                },
                "single_use": true,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg",
            "longitude": -120.52023,
            "latitude": 34.75133,
            "timezone_name": "America/Los_Angeles",
            "total_launch_count": 804,
            "total_landing_count": 26
        }
    },
    "webcast_live": false,
    "program": [],
    "orbital_launch_attempt_count": 6517,
    "location_launch_attempt_count": 729,
    "pad_launch_attempt_count": 95,
    "agency_launch_attempt_count": 3,
    "orbital_launch_attempt_count_year": 149,
    "location_launch_attempt_count_year": 20,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "flightclub_url": null,
    "updates": [
        {
            "id": 5165,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Launch success with satellite deployed.",
            "info_url": "https://fireflyspace.com/news/firefly-aerospace-successfully-launches-victus-nox-with-24-hour-notice/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-09-15T06:44:37Z"
        },
        {
            "id": 5163,
            "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=_CDZyZjDc8Y",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-09-15T02:34:33Z"
        },
        {
            "id": 5158,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding probable launch window",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=58176.msg2523716#msg2523716",
            "created_by": "Nosu",
            "created_on": "2023-09-14T07:28:07Z"
        },
        {
            "id": 3285,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET May",
            "info_url": "https://twitter.com/jeff_foust/status/1623118631893712897",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-02-08T05:51:55Z"
        }
    ],
    "info_urls": [],
    "vid_urls": [
        {
            "priority": 10,
            "source": "www.youtube.com",
            "publisher": null,
            "title": "24 Hour Rocket Launch Operations in 1 Minute!",
            "description": "The successful #VICTUSNOX mission demonstrates Firefly’s capability to launch on-demand and deploy assets when and where customers need them. Our combined co...",
            "feature_image": "https://i.ytimg.com/vi/sW1PBrz0H-g/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=sW1PBrz0H-g",
            "type": {
                "id": 6,
                "name": "Recap"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": null,
            "end_time": null,
            "live": false
        }
    ],
    "timeline": [],
    "pad_turnaround": "P348DT19H27M",
    "mission_patches": [
        {
            "id": 963,
            "name": "Victus Nox",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/victus2520nox_mission_patch_20231227125139.png",
            "agency": {
                "response_mode": "list",
                "id": 265,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/265/?format=api",
                "name": "Firefly Aerospace",
                "abbrev": "FA",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "response_mode": "normal"
        }
    ]
}