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/ee314030-f2f4-461d-b438-b2e661d12591/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "ee314030-f2f4-461d-b438-b2e661d12591",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/ee314030-f2f4-461d-b438-b2e661d12591/?format=api",
    "slug": "safir-rasad-1",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Safir | Rasad 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": "2024-06-13T17:52:19Z",
    "updates": [],
    "net": "2011-06-15T09:15:03Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2011-06-15T09:15:03Z",
    "window_start": "2011-06-15T09:15:03Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 34,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/34/?format=api",
        "name": "Iranian Space Agency",
        "featured": false,
        "type": "Government",
        "country_code": "IRN",
        "abbrev": "ISA",
        "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.",
        "administrator": "Administrator: Hassan Salarieh",
        "founding_year": "2004",
        "launchers": "Safir | Simorgh",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 15,
        "consecutive_successful_launches": 2,
        "successful_launches": 6,
        "failed_launches": 9,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.isa.ir/",
        "wiki_url": "http://en.wikipedia.org/wiki/Iranian_Space_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg",
        "image_url": null,
        "nation_url": null
    },
    "rocket": {
        "id": 1528,
        "configuration": {
            "id": 39,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/39/?format=api",
            "name": "Safir",
            "active": true,
            "reusable": false,
            "description": "",
            "family": "Nodong",
            "full_name": "Safir",
            "manufacturer": {
                "id": 34,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/34/?format=api",
                "name": "Iranian Space Agency",
                "featured": false,
                "type": "Government",
                "country_code": "IRN",
                "abbrev": "ISA",
                "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.",
                "administrator": "Administrator: Hassan Salarieh",
                "founding_year": "2004",
                "launchers": "Safir | Simorgh",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 15,
                "consecutive_successful_launches": 2,
                "successful_launches": 6,
                "failed_launches": 9,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.isa.ir/",
                "wiki_url": "http://en.wikipedia.org/wiki/Iranian_Space_Agency",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg",
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 1,
            "max_stage": 2,
            "length": 22.0,
            "diameter": 1.25,
            "maiden_flight": "2008-08-16",
            "launch_cost": null,
            "launch_mass": 26,
            "leo_capacity": 0,
            "gto_capacity": 0,
            "to_thrust": 255,
            "apogee": 250,
            "vehicle_range": null,
            "image_url": null,
            "info_url": null,
            "wiki_url": null,
            "total_launch_count": 5,
            "consecutive_successful_launches": 4,
            "successful_launches": 4,
            "failed_launches": 1,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": null,
    "pad": {
        "id": 58,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/58/?format=api",
        "agency_id": null,
        "name": "Safir Launch Pad",
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Semnan_Space_Center#Circular_launch_platform",
        "map_url": "https://www.google.com/maps?q=35.23462,53.920936",
        "latitude": "35.23462",
        "longitude": "53.920936",
        "location": {
            "id": 2,
            "url": "https://ll.thespacedevs.com/2.2.0/location/2/?format=api",
            "name": "Semnan Space Center, Islamic Republic of Iran",
            "country_code": "IRN",
            "description": "Semnan Space Center is the primary Iranian spaceport, located 50 km southeast of the city of Semnan in the north of the country.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_2_20200803142458.jpg",
            "timezone_name": "Asia/Tehran",
            "total_launch_count": 15,
            "total_landing_count": 0
        },
        "country_code": "IRN",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_58_20200803143301.jpg",
        "total_launch_count": 8,
        "orbital_launch_attempt_count": 8
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Iran SLV - Safir With Rasad 1",
            "description": "2011-025A/37675 Four on-board cameras of Safir SLV records the telemetry. Launch Date: 2011-06-15 Launch Vehicle: Safir Launch Site: Semnan, Iran Rasad 1, an...",
            "feature_image": "https://i.ytimg.com/vi/RFPoDEqy02Q/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=RFPoDEqy02Q",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": null,
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5132,
    "location_launch_attempt_count": 3,
    "pad_launch_attempt_count": 3,
    "agency_launch_attempt_count": 3,
    "orbital_launch_attempt_count_year": 5132,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P862DT14H41M3S",
    "mission_patches": [],
    "type": "detailed"
}