Modes

Levels of detail in the response - list, normal, detailed

Example - /launches/upcoming/?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, hide_recent_previous, 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/upcoming/?hide_recent_previous=True

Fields searched - 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/upcoming/?search=Starlink

Ordering

Fields - id, last_updated, name, net

Example - /launches/upcoming/?ordering=-last_updated

Number of results

Use limit to control the number of objects in the response (max 100)

Example - /launches/upcoming/?limit=2

Format

Switch to JSON output - /launches/upcoming/?format=json

Help

Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs

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

{
  "count": 209,
  "next": null,
  "previous": "https://lldev.thespacedevs.com/2.3.0/launches/upcoming/?format=api&limit=10&offset=198&ordering=-name",
  "results": [
    {
      "id": "41139aa5-3f45-440a-8131-9cb391ddc995",
      "url": "https://lldev.thespacedevs.com/2.3.0/launches/41139aa5-3f45-440a-8131-9cb391ddc995/?format=api",
      "name": "Angara 1.2 | Kosmos (Unknown Payload)",
      "response_mode": "normal",
      "slug": "angara-12-kosmos-unknown-payload",
      "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-04-11T03:43:38Z",
      "net": "2026-04-30T00:00:00Z",
      "net_precision": {
        "id": 7,
        "name": "Month",
        "abbrev": "M",
        "description": "The T-0 is expected in the given month."
      },
      "window_end": "2026-04-30T00:00:00Z",
      "window_start": "2026-04-30T00:00:00Z",
      "image": {
        "id": 1677,
        "name": "[AUTO] Angara 1.2 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/angara25201.2_image_20190224012254.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193449.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": 193,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/193/?format=api",
        "name": "Russian Space Forces",
        "abbrev": "VKS",
        "type": {
          "id": 1,
          "name": "Government"
        }
      },
      "rocket": {
        "id": 8969,
        "configuration": {
          "response_mode": "list",
          "id": 136,
          "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/136/?format=api",
          "name": "Angara 1.2",
          "families": [
            {
              "response_mode": "list",
              "id": 56,
              "name": "Angara"
            },
            {
              "response_mode": "list",
              "id": 180,
              "name": "Angara 1.2"
            }
          ],
          "full_name": "Angara 1.2",
          "variant": "1.2"
        }
      },
      "mission": {
        "id": 7564,
        "name": "Kosmos (Unknown Payload)",
        "type": "Government/Top Secret",
        "description": "Unknown satellite(s) for the Russian military.",
        "image": null,
        "orbit": {
          "id": 25,
          "name": "Unknown",
          "abbrev": "N/A",
          "celestial_body": {
            "response_mode": "list",
            "id": 1,
            "name": "Earth"
          }
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
      },
      "pad": {
        "id": 42,
        "url": "https://lldev.thespacedevs.com/2.3.0/pads/42/?format=api",
        "active": true,
        "agencies": [
          {
            "response_mode": "normal",
            "id": 163,
            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/163/?format=api",
            "name": "Russian Aerospace Defence Forces",
            "abbrev": "VKO",
            "type": {
              "id": 1,
              "name": "Government"
            },
            "featured": false,
            "country": [
              {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
              }
            ],
            "description": null,
            "administrator": null,
            "founding_year": null,
            "launchers": "",
            "spacecraft": "",
            "parent": "Russian Federal Space Agency (ROSCOSMOS)",
            "image": null,
            "logo": null,
            "social_logo": null
          }
        ],
        "name": "35/1",
        "image": null,
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Plesetsk_Cosmodrome_Site_35",
        "map_url": "https://www.google.com/maps?q=62.927319,40.574897",
        "latitude": 62.927319,
        "longitude": 40.574897,
        "country": {
          "id": 5,
          "name": "Russia",
          "alpha_2_code": "RU",
          "alpha_3_code": "RUS",
          "nationality_name": "Russian",
          "nationality_name_composed": "Russo"
        },
        "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_42_20200803143543.jpg",
        "total_launch_count": 11,
        "orbital_launch_attempt_count": 11,
        "fastest_turnaround": "P63DT6H30M40S",
        "location": {
          "response_mode": "normal",
          "id": 6,
          "url": "https://lldev.thespacedevs.com/2.3.0/locations/6/?format=api",
          "name": "Plesetsk Cosmodrome, Russian Federation",
          "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": 7477,
            "successful_launches": 6922,
            "failed_launches": 555,
            "total_attempted_landings": 1292,
            "successful_landings": 1245,
            "failed_landings": 47
          },
          "active": true,
          "country": {
            "id": 5,
            "name": "Russia",
            "alpha_2_code": "RU",
            "alpha_3_code": "RUS",
            "nationality_name": "Russian",
            "nationality_name_composed": "Russo"
          },
          "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.",
          "image": {
            "id": 1461,
            "name": "Soyuz 2.1b/Fregat-M liftoff from pad 43/3 (Glonass-K2 No. 13, Kosmos 2569)",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20230807181912.jpg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192834.jpeg",
            "credit": "Mil.ru",
            "license": {
              "id": 30,
              "name": "CC BY 4.0",
              "priority": 4,
              "link": "https://creativecommons.org/licenses/by/4.0/"
            },
            "single_use": false,
            "variants": []
          },
          "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg",
          "longitude": 40.577778,
          "latitude": 62.925556,
          "timezone_name": "Europe/Moscow",
          "total_launch_count": 1683,
          "total_landing_count": 0
        }
      },
      "webcast_live": false,
      "program": [],
      "orbital_launch_attempt_count": 7279,
      "location_launch_attempt_count": 1686,
      "pad_launch_attempt_count": 12,
      "agency_launch_attempt_count": 156,
      "orbital_launch_attempt_count_year": 106,
      "location_launch_attempt_count_year": 6,
      "pad_launch_attempt_count_year": 1,
      "agency_launch_attempt_count_year": 4
    }
  ]
}