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/355ab4b9-504c-49ce-84bf-a6df31a0aadf/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "355ab4b9-504c-49ce-84bf-a6df31a0aadf",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/355ab4b9-504c-49ce-84bf-a6df31a0aadf/?format=api",
    "slug": "vega-theos-2-triton-others",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Vega | THEOS-2, TRITON & others",
    "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:24:02Z",
    "updates": [
        {
            "id": 5361,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Successful launch",
            "info_url": "https://twitter.com/arianespace/status/1711241461658718577",
            "created_by": "Nosu",
            "created_on": "2023-10-09T08:06:22Z"
        },
        {
            "id": 5356,
            "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=XknbyH6ipxc",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-09T01:37:02Z"
        },
        {
            "id": 5355,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Livestream has started",
            "info_url": "https://www.youtube.com/watch?v=XknbyH6ipxc",
            "created_by": "LL2",
            "created_on": "2023-10-09T00:56:59Z"
        },
        {
            "id": 5349,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Targeting October 9th at 1:36 UTC",
            "info_url": "https://twitter.com/Arianespace/status/1711057217309331871?t=pKx8U65kTRMTyrMiH9eoXQ&s=19",
            "created_by": "hitura-nobad",
            "created_on": "2023-10-08T16:49:18Z"
        },
        {
            "id": 5343,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed for additional checks.",
            "info_url": "https://twitter.com/Arianespace/status/1710705242906525700",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-07T17:20:34Z"
        },
        {
            "id": 5341,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "GO for launch.",
            "info_url": "https://twitter.com/esa_transport/status/1710672547073679604",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-07T17:03:07Z"
        },
        {
            "id": 5340,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Scrubbed for the day.",
            "info_url": "https://www.youtube.com/watch?v=LjOy_RuwPeA",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-07T01:39:57Z"
        },
        {
            "id": 5339,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Hold at T-14 seconds.",
            "info_url": "https://www.youtube.com/watch?v=LjOy_RuwPeA",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-07T01:37:28Z"
        },
        {
            "id": 5338,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Tweaked T-0 to the second.",
            "info_url": "https://www.youtube.com/watch?v=LjOy_RuwPeA",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-10-07T01:22:56Z"
        },
        {
            "id": 5337,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Livestream has started",
            "info_url": "https://www.youtube.com/watch?v=LjOy_RuwPeA",
            "created_by": "LL2",
            "created_on": "2023-10-07T01:00:27Z"
        },
        {
            "id": 5265,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "GO for launch.",
            "info_url": "https://newsroom.arianespace.com/arianespaces-next-vega-mission-will-embark-12-passengers/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-09-29T14:40:51Z"
        },
        {
            "id": 5254,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET October 7.",
            "info_url": "https://www.bangkokpost.com/thailand/general/2653949",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-09-28T11:54:17Z"
        },
        {
            "id": 5032,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg",
            "comment": "Targeting October 5 (UTC) for Vega launch.",
            "info_url": "https://newsroom.arianespace.com/arianespace-targeting-october-4-for-its-next-vega-launch-vv23/",
            "created_by": "Jay",
            "created_on": "2023-08-31T17:07:25Z"
        },
        {
            "id": 5013,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Targeting September 19",
            "info_url": "https://www.estcube.eu/blog/ESTCube--2%27s-journey-into-space",
            "created_by": "Nosu",
            "created_on": "2023-08-28T06:21:32Z"
        },
        {
            "id": 4870,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Moving THEOS-2 to VV23 as primary payload",
            "info_url": "https://www.thaigov.go.th/news/contents/details/71302",
            "created_by": "Nosu",
            "created_on": "2023-08-16T06:31:44Z"
        },
        {
            "id": 4538,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "NET September",
            "info_url": "https://spacenews.com/europe-leans-on-spacex-to-bridge-launcher-gap/",
            "created_by": "Nosu",
            "created_on": "2023-07-08T10:09:24Z"
        }
    ],
    "net": "2023-10-09T01:36:25Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2023-10-09T01:36:25Z",
    "window_start": "2023-10-09T01:36:25Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 115,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
        "name": "Arianespace",
        "featured": true,
        "type": "Commercial",
        "country_code": "FRA",
        "abbrev": "ASA",
        "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
        "administrator": "CEO: David Cavaillolès",
        "founding_year": "1980",
        "launchers": "Ariane | Vega",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 323,
        "consecutive_successful_launches": 11,
        "successful_launches": 308,
        "failed_launches": 15,
        "pending_launches": 34,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.arianespace.com",
        "wiki_url": "https://en.wikipedia.org/wiki/Arianespace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg"
    },
    "rocket": {
        "id": 7903,
        "configuration": {
            "id": 167,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/167/?format=api",
            "name": "Vega",
            "active": false,
            "reusable": false,
            "description": "Vega is the smallest lifter in the current Arianespace family.",
            "family": "Vega",
            "full_name": "Vega",
            "manufacturer": {
                "id": 159,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/159/?format=api",
                "name": "Avio S.p.A",
                "featured": true,
                "type": "Commercial",
                "country_code": "ITA",
                "abbrev": "Avio",
                "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.",
                "administrator": "CEO: Giulio Ranzo",
                "founding_year": "1908",
                "launchers": "Vega",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 14,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.avio.com/",
                "wiki_url": "https://en.wikipedia.org/wiki/Avio",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 29.9,
            "diameter": 3.025,
            "maiden_flight": "2012-02-13",
            "launch_cost": "37000000",
            "launch_mass": 137,
            "leo_capacity": 1500,
            "gto_capacity": null,
            "to_thrust": 2974,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
            "info_url": "http://www.arianespace.com/vehicle/vega/",
            "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)",
            "total_launch_count": 22,
            "consecutive_successful_launches": 5,
            "successful_launches": 20,
            "failed_launches": 2,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6492,
        "name": "THEOS-2, TRITON & others",
        "description": "THEOS-2 is Thailand’s first Earth observation satellite. Built by Airbus Defense and Space and based on the Astrobus-S platform, it is designed for optical measurements with a ground resolution of approximately 1 meter.\r\n\r\nTRITON or FORMOSAT-7R is an additional satellite by NSPO added to the joint Taiwanese-US FORMOSAT 7 / COSMIC-2 constellation for collecting atmospheric data for weather prediction and for ionosphere, climate and gravity research. Its GNSS Reflectometry payload can be used to calculate the wind speed over sea surfaces.\r\n\r\nCubesats:\r\n\r\nPROBA-V-CC (Project for On-Board Autonomy - Vegetation - Companion CubeSat) (12U) is a mission that will fly a scaled-down version of the vegetation-monitoring instrument aboard the Earth-observing PROBA-V to conduct combined experimental observations with its predecessor.\r\n\r\nPRETTY (Passive REflecTomeTry and dosimetrY) (3U) flies a GPS/Galileo signal reflectometer and radiation monitor for Graz University of Technology of Austria.\r\n\r\nMACSAT (6U) is an In-orbit demonstration (IoD) missionto demonstrate IoT communication over 5G for OQTech.\r\n\r\nCSC-1 and 2 (6U) contains 7 different experimental payloads from various institutions being flown by ISISPACE/ISL.\r\n\r\nN3SS (Nanosat 3U pour la Surveillance du Spectre) (3U) is a demonstration system for detecting and\r\nlocalize radio-frequency jammers on civil spectrum for the French CNES.\r\n\r\nESTCUBE-2 is a technology demonstration mission with multiple scientific payloads for University of Tartu of Estonia.\r\n\r\nANSER LEADER/FOLLOWER 1/2 (Advanced\r\nNanosatellite Systems for Earth observation Research) is a cluster of 3 Earth observing cubesats with panchromatic and hyperspectral cameras for Spain's INTA for monitoring the quality of inland (reservoirs) water over the Iberian Peninsula.",
        "launch_designator": null,
        "type": "Dedicated Rideshare",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [
            {
                "id": 115,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
                "name": "Arianespace",
                "featured": true,
                "type": "Commercial",
                "country_code": "FRA",
                "abbrev": "ASA",
                "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
                "administrator": "CEO: David Cavaillolès",
                "founding_year": "1980",
                "launchers": "Ariane | Vega",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 323,
                "consecutive_successful_launches": 11,
                "successful_launches": 308,
                "failed_launches": 15,
                "pending_launches": 34,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.arianespace.com",
                "wiki_url": "https://en.wikipedia.org/wiki/Arianespace",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg"
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 34,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api",
        "agency_id": 115,
        "name": "Ariane Launch Area 1 (ELV)",
        "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/ELA-1",
        "map_url": "https://www.google.com/maps?q=5.236,-52.775",
        "latitude": "5.236",
        "longitude": "-52.775",
        "location": {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "timezone_name": "America/Cayenne",
            "total_launch_count": 329,
            "total_landing_count": 0
        },
        "country_code": "GUF",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg",
        "total_launch_count": 54,
        "orbital_launch_attempt_count": 54
    },
    "infoURLs": [
        {
            "priority": 10,
            "source": "newsroom.arianespace.com",
            "title": "VV23 Press Kit",
            "description": null,
            "feature_image": null,
            "url": "https://newsroom.arianespace.com/download?picid=50843&pn=231006_PRESS%20KIT%20VV23%20(EN)-pdf",
            "type": {
                "id": 2,
                "name": "Official Press Kit"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Flight VV23 - 8 October – Golden Horizon | THEOS-2 & FORMOSAT-7R/TRITON | Vega Launch | Arianespace",
            "description": "Summary: \n00:00:00 Start of the livestream\n00:01:07 What happened 48H ago\n00:03:28 Key phases of the VV23 flight\n00:06:11 What About - FORMOSAT-7R/TRITON\n00:09:23 What About - THEOS-2\n00:12:40 What Ab...",
            "feature_image": "https://i.ytimg.com/vi/XknbyH6ipxc/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=XknbyH6ipxc",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2023-10-09T00:56:32Z",
            "end_time": "2023-10-09T03:33:50Z"
        },
        {
            "priority": 11,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Vol VV23 8 octobre - “Golden Horizon” | THEOS-2 & FORMOSAT-7R/TRITON | Lancement Vega | Arianespace",
            "description": "Sommaire :\n00:00:00 Début du direct\n00:01:07 48h avant\n00:03:28 Phases clés du vol VV23\n00:06:11 What About - FORMOSAT-7R/TRITON\n00:09:23 What About - THEOS-2\n00:12:40 What About - IOD/IOV\n00:16:24 Di...",
            "feature_image": "https://i.ytimg.com/vi/SZjyWHPVSi8/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=SZjyWHPVSi8",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 4,
                "name": "French",
                "code": "fr"
            },
            "start_time": "2023-10-09T00:57:28Z",
            "end_time": "2023-10-09T03:33:56Z"
        },
        {
            "priority": 12,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Flight VV23 – Golden Horizon | THEOS-2 & FORMOSAT-7R/TRITON | Vega Launch | Arianespace",
            "description": "Arianespace’s next mission is targeted on Friday, October 6, 2023 at 10:36 p.m. local time (October 7, at 01:36 a.m. UTC), from Europe’s Spaceport in French Guiana with a Vega launcher. The mission, c...",
            "feature_image": "https://i.ytimg.com/vi/LjOy_RuwPeA/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=LjOy_RuwPeA",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2023-10-07T00:58:47Z",
            "end_time": "2023-10-07T01:53:53Z"
        },
        {
            "priority": 13,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Vol VV23 – “Golden Horizon” | THEOS-2 & FORMOSAT-7R/TRITON | Lancement Vega | Arianespace",
            "description": "La prochaine mission d’Arianespace est prévue le jeudi 6 octobre 2023 à 22h36 heure locale (01h36 UTC) depuis le port spatial européen de Kourou, en Guyane française, avec un lanceur Vega. Cette missi...",
            "feature_image": "https://i.ytimg.com/vi/gOaG8hZV6ok/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=gOaG8hZV6ok",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 4,
                "name": "French",
                "code": "fr"
            },
            "start_time": "2023-10-07T00:58:48Z",
            "end_time": "2023-10-07T01:53:59Z"
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega2520257c_image_20231009052620.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6532,
    "location_launch_attempt_count": 320,
    "pad_launch_attempt_count": 49,
    "agency_launch_attempt_count": 315,
    "orbital_launch_attempt_count_year": 164,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 3,
    "pad_turnaround": "P291DT23H48M54S",
    "mission_patches": [
        {
            "id": 897,
            "name": "Vega V23",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/vega2520v23_mission_patch_20230929154047.png",
            "agency": {
                "id": 115,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
                "name": "Arianespace",
                "type": "Commercial"
            }
        }
    ],
    "type": "detailed"
}