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/413208eb-4bcd-4a4c-a56c-f3f93c5e16e0/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "413208eb-4bcd-4a4c-a56c-f3f93c5e16e0",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/413208eb-4bcd-4a4c-a56c-f3f93c5e16e0/?format=api",
    "slug": "zenit-3f-elektro-l-no1",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Zenit-3F | Elektro-L No.1",
    "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
    },
    "last_updated": "2023-06-14T03:30:57Z",
    "updates": [],
    "net": "2011-01-20T12:29:01Z",
    "net_precision": null,
    "window_end": "2011-01-20T12:29:01Z",
    "window_start": "2011-01-20T12:29:01Z",
    "probability": -1,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": null,
    "hashtag": null,
    "launch_service_provider": {
        "id": 63,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
        "name": "Russian Federal Space Agency (ROSCOSMOS)",
        "featured": true,
        "type": "Government",
        "country_code": "RUS",
        "abbrev": "RFSA",
        "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.",
        "administrator": "Administrator: Yuri Borisov",
        "founding_year": "1992",
        "launchers": "Soyuz",
        "spacecraft": "Soyuz",
        "launch_library_url": null,
        "total_launch_count": 331,
        "consecutive_successful_launches": 55,
        "successful_launches": 320,
        "failed_launches": 11,
        "pending_launches": 10,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://en.roscosmos.ru/",
        "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg"
    },
    "rocket": {
        "id": 1506,
        "configuration": {
            "id": 58,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/58/?format=api",
            "name": "Zenit 3F",
            "active": false,
            "reusable": false,
            "description": "",
            "family": "Zenith",
            "full_name": "Zenit",
            "manufacturer": {
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "featured": true,
                "type": "Government",
                "country_code": "RUS",
                "abbrev": "RFSA",
                "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.",
                "administrator": "Administrator: Yuri Borisov",
                "founding_year": "1992",
                "launchers": "Soyuz",
                "spacecraft": "Soyuz",
                "launch_library_url": null,
                "total_launch_count": 331,
                "consecutive_successful_launches": 55,
                "successful_launches": 320,
                "failed_launches": 11,
                "pending_launches": 10,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://en.roscosmos.ru/",
                "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 1,
            "max_stage": 1,
            "length": 4.6,
            "diameter": 0.42,
            "maiden_flight": "2011-01-20",
            "launch_cost": null,
            "launch_mass": 0,
            "leo_capacity": 0,
            "gto_capacity": 0,
            "to_thrust": 45,
            "apogee": 140,
            "vehicle_range": null,
            "image_url": null,
            "info_url": null,
            "wiki_url": null,
            "total_launch_count": 4,
            "consecutive_successful_launches": 4,
            "successful_launches": 4,
            "failed_launches": 0,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 895,
        "name": "Elektro-L No.1",
        "description": "Elektro-L is a series of meteorological satellites developed for the Russian Federal Space Agency by NPO Lavochkin. Electro-L №1 was the first of the series and became the first Russian weather satellite that successfully operates in geostationary orbit. It is designed to capture real-time images of clouds and the Earth’s underlying surface, heliogeophysical measurements, collection and translating hydrometeorological and service data.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 2,
            "name": "Geostationary Transfer Orbit",
            "abbrev": "GTO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 2,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/2/?format=api",
        "agency_id": null,
        "name": "45/1",
        "description": null,
        "info_url": null,
        "wiki_url": "",
        "map_url": "https://www.google.com/maps?q=45.943492,63.653014",
        "latitude": "45.943492",
        "longitude": "63.653014",
        "location": {
            "id": 15,
            "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api",
            "name": "Baikonur Cosmodrome, Republic of Kazakhstan",
            "country_code": "KAZ",
            "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg",
            "timezone_name": "Asia/Qyzylorda",
            "total_launch_count": 1555,
            "total_landing_count": 0
        },
        "country_code": "KAZ",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_2_20200803143256.jpg",
        "total_launch_count": 46,
        "orbital_launch_attempt_count": 46
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Пуск РКН Зенит-2СБ с КА Электро-Л",
            "description": "20 января 2011 года в 15.29 мск со стартового комплекса площадки 45 космодрома Байконур стартовыми расчетами предприятий ракетно-космических отраслей России ...",
            "feature_image": "https://i.ytimg.com/vi/kXhJx3NquGM/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=kXhJx3NquGM",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": null,
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5107,
    "location_launch_attempt_count": 1356,
    "pad_launch_attempt_count": 40,
    "agency_launch_attempt_count": 200,
    "orbital_launch_attempt_count_year": 1,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P415DT15H29M1S",
    "mission_patches": [],
    "type": "detailed"
}