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__agency__ids, 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 - lldev.thespacedevs.com/docs

GET /2.3.0/launches/?format=api&offset=550&ordering=net
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 551,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/launches/?format=api&limit=10&offset=540&ordering=net",
    "results": [
        {
            "id": "4cc61288-6f94-41de-8fd5-7fe4d72aedfb",
            "url": "https://lldev.thespacedevs.com/2.3.0/launches/4cc61288-6f94-41de-8fd5-7fe4d72aedfb/?format=api",
            "name": "Falcon 9 Block 5 | Haven-1",
            "response_mode": "normal",
            "slug": "falcon-9-block-5-haven-1",
            "launch_designator": null,
            "status": {
                "id": 2,
                "name": "To Be Determined",
                "abbrev": "TBD",
                "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
            },
            "last_updated": "2026-01-20T20:07:01Z",
            "net": "2027-03-31T00:00:00Z",
            "net_precision": {
                "id": 8,
                "name": "Quarter 1",
                "abbrev": "Q1",
                "description": "The T-0 is expected in the first quarter of the given year."
            },
            "window_end": "2027-03-31T00:00:00Z",
            "window_start": "2027-03-31T00:00:00Z",
            "image": {
                "id": 1736,
                "name": "[AUTO] Falcon 9 - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193628.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": "list",
                "id": 121,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api",
                "name": "SpaceX",
                "abbrev": "SpX",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "rocket": {
                "id": 7851,
                "configuration": {
                    "response_mode": "list",
                    "id": 164,
                    "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/164/?format=api",
                    "name": "Falcon 9",
                    "families": [
                        {
                            "response_mode": "list",
                            "id": 1,
                            "name": "Falcon"
                        },
                        {
                            "response_mode": "list",
                            "id": 176,
                            "name": "Falcon 9"
                        }
                    ],
                    "full_name": "Falcon 9 Block 5",
                    "variant": "Block 5"
                }
            },
            "mission": {
                "id": 6358,
                "name": "Haven-1",
                "type": "Human Exploration",
                "description": "Commercial space station developed by Vast",
                "image": null,
                "orbit": {
                    "id": 8,
                    "name": "Low Earth Orbit",
                    "abbrev": "LEO",
                    "celestial_body": {
                        "response_mode": "list",
                        "id": 1,
                        "name": "Earth"
                    }
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 72,
                "url": "https://lldev.thespacedevs.com/2.3.0/pads/72/?format=api",
                "active": true,
                "agencies": [],
                "name": "Unknown Pad",
                "image": null,
                "description": null,
                "info_url": null,
                "wiki_url": "",
                "map_url": "https://www.google.com/maps?q=28.458,-80.528",
                "latitude": 28.458,
                "longitude": -80.528,
                "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-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_72_20200803143403.jpg",
                "total_launch_count": 0,
                "orbital_launch_attempt_count": 0,
                "fastest_turnaround": null,
                "location": {
                    "response_mode": "normal",
                    "id": 12,
                    "url": "https://lldev.thespacedevs.com/2.3.0/locations/12/?format=api",
                    "name": "Cape Canaveral SFS, FL, 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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
                            "thumbnail_url": "https://thespacedevs-dev.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": 7470,
                        "successful_launches": 6915,
                        "failed_launches": 555,
                        "total_attempted_landings": 1288,
                        "successful_landings": 1241,
                        "failed_landings": 47
                    },
                    "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": "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.",
                    "image": {
                        "id": 2200,
                        "name": "Cape Canaveral & KSC seen from orbit (STS-43)",
                        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg",
                        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": []
                    },
                    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
                    "longitude": -80.577778,
                    "latitude": 28.488889,
                    "timezone_name": "America/New_York",
                    "total_launch_count": 1100,
                    "total_landing_count": 71
                }
            },
            "webcast_live": false,
            "program": [],
            "orbital_launch_attempt_count": 7453,
            "location_launch_attempt_count": 1164,
            "pad_launch_attempt_count": 32,
            "agency_launch_attempt_count": 730,
            "orbital_launch_attempt_count_year": 12,
            "location_launch_attempt_count_year": 5,
            "pad_launch_attempt_count_year": 4,
            "agency_launch_attempt_count_year": 8
        }
    ]
}