GET

Launch List

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/?format=api&offset=7490&ordering=-id
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 7491,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=7480&ordering=-id",
    "results": [
        {
            "id": "000fbb81-80c8-4095-a811-aa561ce9ed3c",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/000fbb81-80c8-4095-a811-aa561ce9ed3c/?format=api",
            "slug": "delta-iv-heavy-nrol-26-usa-202",
            "name": "Delta IV Heavy | NROL-26 (USA-202)",
            "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-13T10:23:31Z",
            "net": "2009-01-18T02:47:00Z",
            "window_end": "2009-01-18T02:47:00Z",
            "window_start": "2009-01-18T02:47:00Z",
            "net_precision": null,
            "probability": 0,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "",
            "hashtag": null,
            "launch_service_provider": {
                "id": 124,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api",
                "name": "United Launch Alliance",
                "type": "Commercial"
            },
            "rocket": {
                "id": 1407,
                "configuration": {
                    "id": 21,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/21/?format=api",
                    "name": "Delta IV Heavy",
                    "family": "Delta",
                    "full_name": "Delta IV Heavy",
                    "variant": "Heavy"
                }
            },
            "mission": {
                "id": 553,
                "name": "NROL-26 (USA-202)",
                "description": "A military reconnaissance satellite, it's purpose is classified.",
                "launch_designator": null,
                "type": "Government/Top Secret",
                "orbit": {
                    "id": 2,
                    "name": "Geostationary Transfer Orbit",
                    "abbrev": "GTO"
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 38,
                "url": "https://ll.thespacedevs.com/2.2.0/pad/38/?format=api",
                "agency_id": null,
                "name": "Space Launch Complex 37B",
                "description": "",
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_37",
                "map_url": "https://www.google.com/maps?q=28.5317,-80.56495",
                "latitude": "28.5317",
                "longitude": "-80.56495",
                "location": {
                    "id": 12,
                    "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api",
                    "name": "Cape Canaveral SFS, FL, USA",
                    "country_code": "USA",
                    "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
                    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
                    "timezone_name": "America/New_York",
                    "total_launch_count": 1021,
                    "total_landing_count": 64
                },
                "country_code": "USA",
                "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_38_20200803143515.jpg",
                "total_launch_count": 40,
                "orbital_launch_attempt_count": 40
            },
            "webcast_live": false,
            "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy__image_20240313102319.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 4955,
            "location_launch_attempt_count": 658,
            "pad_launch_attempt_count": 14,
            "agency_launch_attempt_count": 23,
            "orbital_launch_attempt_count_year": 1,
            "location_launch_attempt_count_year": 1,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 1,
            "type": "normal"
        }
    ]
}