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

{
  "count": 502,
  "next": null,
  "previous": "https://lldev.thespacedevs.com/2.3.0/launches/?format=api&limit=10&offset=490&ordering=-id",
  "results": [
    {
      "id": "011f18f2-16a8-41a8-8257-416bb9915138",
      "url": "https://lldev.thespacedevs.com/2.3.0/launches/011f18f2-16a8-41a8-8257-416bb9915138/?format=api",
      "name": "Long March 2C | Shijian 30 A-C",
      "response_mode": "normal",
      "slug": "long-march-2c-shijian-30-a-c",
      "launch_designator": "2025-266",
      "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
      },
      "last_updated": "2025-11-19T09:34:35Z",
      "net": "2025-11-19T04:01:00Z",
      "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
      },
      "window_end": "2025-11-19T04:19:00Z",
      "window_start": "2025-11-19T03:52:00Z",
      "image": {
        "id": 2559,
        "name": "CZ-2C liftoff (Shijian 30 A-C)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cz-2c_liftoff__image_20251119093404.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cz-2c_liftoff__image_thumbnail_20251119093405.jpeg",
        "credit": "中国军号",
        "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": 88,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "abbrev": "CASC",
        "type": {
          "id": 1,
          "name": "Government"
        }
      },
      "rocket": {
        "id": 8804,
        "configuration": {
          "response_mode": "list",
          "id": 61,
          "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/61/?format=api",
          "name": "Long March 2C",
          "families": [
            {
              "response_mode": "list",
              "id": 106,
              "name": "Long March"
            },
            {
              "response_mode": "list",
              "id": 109,
              "name": "Long March 2"
            }
          ],
          "full_name": "Long March 2C",
          "variant": "C"
        }
      },
      "mission": {
        "id": 7395,
        "name": "Shijian 30 A-C",
        "type": "Government/Top Secret",
        "description": "3 Chinese satellites described as for “Space Environment Measurements” purposes. Actual usage not known.",
        "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": 22,
        "url": "https://lldev.thespacedevs.com/2.3.0/pads/22/?format=api",
        "active": true,
        "agencies": [],
        "name": "Launch Area 94 (SLS-2 / 603)",
        "image": {
          "id": 1375,
          "name": "Long March 2D liftoff from Launch Area 4 (Yaogan 37 & Shiyan 22A/B)",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20230907133532.jpeg",
          "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192550.jpeg",
          "credit": "Xinhua/Wang Jiangbo",
          "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
          },
          "single_use": false,
          "variants": []
        },
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4",
        "map_url": "https://www.google.com/maps?q=40.960482,100.298059",
        "latitude": 40.960482,
        "longitude": 100.298059,
        "country": {
          "id": 6,
          "name": "China",
          "alpha_2_code": "CN",
          "alpha_3_code": "CHN",
          "nationality_name": "Chinese",
          "nationality_name_composed": "Sino"
        },
        "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_22_20200803143437.jpg",
        "total_launch_count": 139,
        "orbital_launch_attempt_count": 139,
        "fastest_turnaround": "P10DT18H22M",
        "location": {
          "response_mode": "normal",
          "id": 17,
          "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api",
          "name": "Jiuquan Satellite Launch Center, People's Republic of China",
          "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": 7651,
            "successful_launches": 7094,
            "failed_launches": 557,
            "total_attempted_landings": 1384,
            "successful_landings": 1335,
            "failed_landings": 49
          },
          "active": true,
          "country": {
            "id": 6,
            "name": "China",
            "alpha_2_code": "CN",
            "alpha_3_code": "CHN",
            "nationality_name": "Chinese",
            "nationality_name_composed": "Sino"
          },
          "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
          "image": {
            "id": 1374,
            "name": "Long March 2F/G liftoff (Shenzhou 16)",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg",
            "credit": "CMS",
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": false,
            "variants": []
          },
          "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
          "longitude": 100.291111,
          "latitude": 40.958056,
          "timezone_name": "Asia/Shanghai",
          "total_launch_count": 300,
          "total_landing_count": 3
        }
      },
      "webcast_live": false,
      "program": [],
      "orbital_launch_attempt_count": 7122,
      "location_launch_attempt_count": 265,
      "pad_launch_attempt_count": 130,
      "agency_launch_attempt_count": 555,
      "orbital_launch_attempt_count_year": 273,
      "location_launch_attempt_count_year": 26,
      "pad_launch_attempt_count_year": 11,
      "agency_launch_attempt_count_year": 54
    },
    {
      "id": "00e88b18-f8d1-4dbc-84e1-5e5067fdf0c6",
      "url": "https://lldev.thespacedevs.com/2.3.0/launches/00e88b18-f8d1-4dbc-84e1-5e5067fdf0c6/?format=api",
      "name": "Electron | PolSIR-1",
      "response_mode": "normal",
      "slug": "electron-polsir-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-06-26T04:57:12Z",
      "net": "2027-06-30T00:00:00Z",
      "net_precision": {
        "id": 7,
        "name": "Month",
        "abbrev": "M",
        "description": "The T-0 is expected in the given month."
      },
      "window_end": "2027-06-30T00:00:00Z",
      "window_start": "2027-06-30T00:00:00Z",
      "image": {
        "id": 1727,
        "name": "[AUTO] Electron - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193613.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": 147,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/147/?format=api",
        "name": "Rocket Lab",
        "abbrev": "RL",
        "type": {
          "id": 3,
          "name": "Commercial"
        }
      },
      "rocket": {
        "id": 9074,
        "configuration": {
          "response_mode": "list",
          "id": 26,
          "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/26/?format=api",
          "name": "Electron",
          "families": [],
          "full_name": "Electron",
          "variant": ""
        }
      },
      "mission": {
        "id": 7669,
        "name": "PolSIR-1",
        "type": "Earth Science",
        "description": "The PoISIR (Polarized Submillimeter Ice-cloud Radiometer) mission will help provide a better understanding of ice clouds that form at high altitudes throughout tropical and subtropical regions.\r\n\r\nConsisting of two small satellites, both of PoISIR’s 16U CubeSats have a scientific instrument designed to measure a specific spectrum of electromagnetic radiation, which will determine how the amount of ice in tropical clouds rises and falls during the day, as well as how the ice changes connect to larger storms. The instruments also will help determine how ice clouds affect sunlight and heat radiation throughout the day. \r\n\r\nThe pair of CubeSats will fly in orbits separated by several hours to observe the pattern of cloud ice content changes over a day. This information will help researchers make more accurate weather predictions.",
        "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": 210,
        "url": "https://lldev.thespacedevs.com/2.3.0/pads/210/?format=api",
        "active": true,
        "agencies": [],
        "name": "Unknown Pad",
        "image": null,
        "description": null,
        "info_url": null,
        "wiki_url": null,
        "map_url": null,
        "latitude": -39.260881,
        "longitude": 177.865826,
        "country": {
          "id": 51,
          "name": "New Zealand",
          "alpha_2_code": "NZ",
          "alpha_3_code": "NZL",
          "nationality_name": "Kiwi",
          "nationality_name_composed": "Kiwi"
        },
        "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_210_20230819165718.jpg",
        "total_launch_count": 0,
        "orbital_launch_attempt_count": 0,
        "fastest_turnaround": null,
        "location": {
          "response_mode": "normal",
          "id": 10,
          "url": "https://lldev.thespacedevs.com/2.3.0/locations/10/?format=api",
          "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand",
          "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": 7651,
            "successful_launches": 7094,
            "failed_launches": 557,
            "total_attempted_landings": 1384,
            "successful_landings": 1335,
            "failed_landings": 49
          },
          "active": true,
          "country": {
            "id": 51,
            "name": "New Zealand",
            "alpha_2_code": "NZ",
            "alpha_3_code": "NZL",
            "nationality_name": "Kiwi",
            "nationality_name_composed": "Kiwi"
          },
          "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.",
          "image": {
            "id": 2206,
            "name": "Rocket Lab Launch Complex 1",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_20240918164228.jpg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_thumbnail_20240918164228.jpeg",
            "credit": "Rocket Lab",
            "license": {
              "id": 7,
              "name": "Rocket Lab Image Use Policy",
              "priority": 3,
              "link": "https://www.rocketlabusa.com/about/gallery/"
            },
            "single_use": true,
            "variants": []
          },
          "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg",
          "longitude": 177.86586,
          "latitude": -39.26085,
          "timezone_name": "Pacific/Auckland",
          "total_launch_count": 85,
          "total_landing_count": 17
        }
      },
      "webcast_live": false,
      "program": [],
      "orbital_launch_attempt_count": 7590,
      "location_launch_attempt_count": 97,
      "pad_launch_attempt_count": 12,
      "agency_launch_attempt_count": 113,
      "orbital_launch_attempt_count_year": 58,
      "location_launch_attempt_count_year": 4,
      "pad_launch_attempt_count_year": 4,
      "agency_launch_attempt_count_year": 4
    }
  ]
}