GET

Launch Instance

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/48a578ae-7a03-4597-9348-6ec95b4c01d3/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "48a578ae-7a03-4597-9348-6ec95b4c01d3",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/48a578ae-7a03-4597-9348-6ec95b4c01d3/?format=api",
  "slug": "new-glenn-blue-origin-hls-leo-demo",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "New Glenn | Blue Origin HLS LEO Demo",
  "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-08-22T00:38:01Z",
  "updates": [
    {
      "id": 15924,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Added launch.",
      "info_url": "https://x.com/spaceflightnow/status/2090887985864540208",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-08-22T00:38:00Z"
    }
  ],
  "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",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 141,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api",
    "name": "Blue Origin",
    "featured": true,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "BO",
    "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
    "administrator": "CEO: Jeff Bezos",
    "founding_year": "2000",
    "launchers": "New Shepard | New Glenn",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 41,
    "consecutive_successful_launches": 0,
    "successful_launches": 39,
    "failed_launches": 2,
    "pending_launches": 5,
    "consecutive_successful_landings": 12,
    "successful_landings": 38,
    "failed_landings": 3,
    "attempted_landings": 41,
    "info_url": "https://www.blueorigin.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
  },
  "rocket": {
    "id": 9123,
    "configuration": {
      "id": 138,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/138/?format=api",
      "name": "New Glenn",
      "active": true,
      "reusable": true,
      "description": "The New Glenn is a privately funded orbital launch vehicle in development by Blue Origin. New Glenn is described as a 7-meter-diameter (23 ft), two- or three-stage rocket.",
      "family": "New Glenn",
      "full_name": "New Glenn",
      "manufacturer": {
        "id": 141,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api",
        "name": "Blue Origin",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "BO",
        "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
        "administrator": "CEO: Jeff Bezos",
        "founding_year": "2000",
        "launchers": "New Shepard | New Glenn",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 41,
        "consecutive_successful_launches": 0,
        "successful_launches": 39,
        "failed_launches": 2,
        "pending_launches": 5,
        "consecutive_successful_landings": 12,
        "successful_landings": 38,
        "failed_landings": 3,
        "attempted_landings": 41,
        "info_url": "https://www.blueorigin.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 98.0,
      "diameter": 7.0,
      "maiden_flight": "2025-01-16",
      "launch_cost": null,
      "launch_mass": null,
      "leo_capacity": 45000,
      "gto_capacity": 13000,
      "to_thrust": 17126,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
      "info_url": "https://www.blueorigin.com/new-glenn/",
      "wiki_url": "https://en.wikipedia.org/wiki/New_Glenn",
      "total_launch_count": 3,
      "consecutive_successful_launches": 0,
      "successful_launches": 2,
      "failed_launches": 1,
      "pending_launches": 5,
      "attempted_landings": 3,
      "successful_landings": 2,
      "failed_landings": 1,
      "consecutive_successful_landings": 2
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7718,
    "name": "Blue Origin HLS LEO Demo",
    "description": "The Blue Moon HLS pathfinder spacecraft in support of NASA's Artemis III mission in Low Earth Orbit will be a modified Blue Moon Mark 1 vehicle equipped with a docking mechanism, a crew cabin and environmental control systems on board. This Blue Moon HLS will launch before the Artemis III Orion has launched into LEO aboard SLS. Once docked, Orion and Blue Moon will spend about two days docked together for tests and technology demonstrations, with the Artemis III crew scheduled to enter the lander.",
    "launch_designator": null,
    "type": "Human Exploration",
    "orbit": {
      "id": 8,
      "name": "Low Earth Orbit",
      "abbrev": "LEO"
    },
    "agencies": [
      {
        "id": 141,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api",
        "name": "Blue Origin",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "BO",
        "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
        "administrator": "CEO: Jeff Bezos",
        "founding_year": "2000",
        "launchers": "New Shepard | New Glenn",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 41,
        "consecutive_successful_launches": 0,
        "successful_launches": 39,
        "failed_launches": 2,
        "pending_launches": 5,
        "consecutive_successful_landings": 12,
        "successful_landings": 38,
        "failed_landings": 3,
        "attempted_landings": 41,
        "info_url": "https://www.blueorigin.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
      }
    ],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 121,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/121/?format=api",
    "agency_id": 161,
    "name": "Launch Complex 36A",
    "description": null,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_36",
    "map_url": "https://www.google.com/maps?q=28.4705556,-80.542194",
    "latitude": "28.4705556",
    "longitude": "-80.542194",
    "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": 1127,
      "total_landing_count": 77
    },
    "country_code": "USA",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_121_20200803143231.jpg",
    "total_launch_count": 71,
    "orbital_launch_attempt_count": 71
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 7564,
  "location_launch_attempt_count": 1187,
  "pad_launch_attempt_count": 75,
  "agency_launch_attempt_count": 45,
  "orbital_launch_attempt_count_year": 44,
  "location_launch_attempt_count_year": 17,
  "pad_launch_attempt_count_year": 2,
  "agency_launch_attempt_count_year": 2,
  "pad_turnaround": "P91D",
  "mission_patches": [],
  "type": "detailed"
}