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/20d9789c-dfdf-46b5-a964-de5f031615a5/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "20d9789c-dfdf-46b5-a964-de5f031615a5",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/20d9789c-dfdf-46b5-a964-de5f031615a5/?format=api",
  "slug": "launcherone-launch-demo-2",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "LauncherOne | Launch Demo 2",
  "status": {
    "id": 3,
    "name": "Launch Successful",
    "abbrev": "Success",
    "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
  },
  "last_updated": "2023-06-14T03:54:38Z",
  "updates": [
    {
      "id": 204,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
      "comment": "",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1350933162398986240?s=19",
      "created_by": "Nosu",
      "created_on": "2021-01-17T22:32:28Z"
    },
    {
      "id": 203,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "Adjusting T-0",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1350869843868676097",
      "created_by": "SwGustav",
      "created_on": "2021-01-17T18:19:45Z"
    },
    {
      "id": 202,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "Updating T-0",
      "info_url": "https://twitter.com/virgin_orbit/status/1350839742900760576?s=21",
      "created_by": "SwGustav",
      "created_on": "2021-01-17T16:23:07Z"
    },
    {
      "id": 201,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
      "comment": "Correcting launch window.",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1349070238873108481",
      "created_by": "spacevogel",
      "created_on": "2021-01-17T15:19:56Z"
    },
    {
      "id": 200,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "Still no official updates today, setting TBC",
      "info_url": null,
      "created_by": "SwGustav",
      "created_on": "2021-01-17T14:55:23Z"
    },
    {
      "id": 189,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "NET Jan 17th",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1349027906991792130",
      "created_by": "SwGustav",
      "created_on": "2021-01-12T16:36:50Z"
    },
    {
      "id": 180,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
      "comment": "",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1347244235787968512",
      "created_by": "spacevogel",
      "created_on": "2021-01-07T18:28:39Z"
    },
    {
      "id": 178,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "Setting GO",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1346549448583782401",
      "created_by": "SwGustav",
      "created_on": "2021-01-05T20:45:06Z"
    },
    {
      "id": 171,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
      "comment": "",
      "info_url": "https://forum.nasaspaceflight.com/index.php?topic=51425.msg2174141#msg2174141",
      "created_by": "Nosu",
      "created_on": "2020-12-31T20:10:52Z"
    },
    {
      "id": 165,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg",
      "comment": "\"..currently, the window is likely to be mid-January\"",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1341810180254666752",
      "created_by": "spacevogel",
      "created_on": "2020-12-23T18:42:50Z"
    },
    {
      "id": 137,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Launch slip",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1337911913036959744",
      "created_by": "Cosmic_Penguin",
      "created_on": "2020-12-13T07:08:00Z"
    },
    {
      "id": 76,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "",
      "info_url": "https://twitter.com/Virgin_Orbit/status/1333467683132637185?s=20",
      "created_by": "SwGustav",
      "created_on": "2020-11-30T17:55:17Z"
    },
    {
      "id": 64,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
      "comment": "",
      "info_url": "https://twitter.com/K7TABravo/status/1331709255070584835",
      "created_by": "SwGustav",
      "created_on": "2020-11-26T20:59:19Z"
    }
  ],
  "net": "2021-01-17T19:38:51Z",
  "net_precision": null,
  "window_end": "2021-01-17T22:00:00Z",
  "window_start": "2021-01-17T18:00:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 199,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/199/?format=api",
    "name": "Virgin Orbit",
    "featured": false,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "VO",
    "description": "Virgin Orbit is a company within the Virgin Group which plans to provide launch services for small satellites. The company was formed in 2017 to develop the air-launched LauncherOne rocket, launched from Cosmic Girl, which had previously been a project of Virgin Galactic. Based in Long Beach, California, Virgin Orbit has more than 300 employees led by president Dan Hart, a former vice president of government satellite systems at Boeing.\r\n\r\nVirgin Orbit focuses on small satellite launch, which is one of three capabilities being focused on by Virgin Galactic. These capabilities are: human spaceflight operations, small satellite launch, and advanced aerospace design, manufacturing, and test",
    "administrator": "President: Dan Hart",
    "founding_year": "2017",
    "launchers": "LauncherOne",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 6,
    "consecutive_successful_launches": 0,
    "successful_launches": 4,
    "failed_launches": 2,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://virginorbit.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Orbit",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_logo_20200101102856.png",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg",
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_nation_20200101103026.jpeg"
  },
  "rocket": {
    "id": 2736,
    "configuration": {
      "id": 141,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/141/?format=api",
      "name": "LauncherOne",
      "active": false,
      "reusable": false,
      "description": "LauncherOne is a two stage orbital launch vehicle developed by Virgin Orbit since 2007. It is an air launch to orbit rocket, designed to launch \"smallsat\" payloads of 300 kilograms (660 lb) into a Sun-synchronous orbit, following air launch from a carrier aircraft at high altitude.",
      "family": "",
      "full_name": "LauncherOne",
      "manufacturer": {
        "id": 199,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/199/?format=api",
        "name": "Virgin Orbit",
        "featured": false,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "VO",
        "description": "Virgin Orbit is a company within the Virgin Group which plans to provide launch services for small satellites. The company was formed in 2017 to develop the air-launched LauncherOne rocket, launched from Cosmic Girl, which had previously been a project of Virgin Galactic. Based in Long Beach, California, Virgin Orbit has more than 300 employees led by president Dan Hart, a former vice president of government satellite systems at Boeing.\r\n\r\nVirgin Orbit focuses on small satellite launch, which is one of three capabilities being focused on by Virgin Galactic. These capabilities are: human spaceflight operations, small satellite launch, and advanced aerospace design, manufacturing, and test",
        "administrator": "President: Dan Hart",
        "founding_year": "2017",
        "launchers": "LauncherOne",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 6,
        "consecutive_successful_launches": 0,
        "successful_launches": 4,
        "failed_launches": 2,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://virginorbit.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Orbit",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_logo_20200101102856.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_nation_20200101103026.jpeg"
      },
      "program": [],
      "variant": "One",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 16.0,
      "diameter": 1.6,
      "maiden_flight": "2020-05-25",
      "launch_cost": "12000000",
      "launch_mass": 30,
      "leo_capacity": 500,
      "gto_capacity": null,
      "to_thrust": 327,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/launcherone_image_20200101110016.jpeg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/LauncherOne",
      "total_launch_count": 6,
      "consecutive_successful_launches": 0,
      "successful_launches": 4,
      "failed_launches": 2,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 496,
    "name": "Launch Demo 2 (VCLS ELaNa XX)",
    "description": "This is Virgin Orbit's second attempt to launch the LauncherOne rocket. It also carries cubesats which were contracted by NASA through Venture Class Launch Services contract.",
    "launch_designator": null,
    "type": "Dedicated Rideshare",
    "orbit": {
      "id": 13,
      "name": "Polar Orbit",
      "abbrev": "PO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 53,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/53/?format=api",
    "agency_id": null,
    "name": "Mojave Air and Space Port",
    "description": null,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Mojave_Air_and_Space_Port",
    "map_url": "https://www.google.com/maps?q=35.059444,-118.151667",
    "latitude": "35.059444",
    "longitude": "-118.151667",
    "location": {
      "id": 20,
      "url": "https://ll.thespacedevs.com/2.2.0/location/20/?format=api",
      "name": "Air launch to orbit",
      "country_code": "???",
      "description": "",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_20_20200803142433.jpg",
      "timezone_name": "",
      "total_launch_count": 52,
      "total_landing_count": 0
    },
    "country_code": "USA",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_53_20200803143612.jpg",
    "total_launch_count": 5,
    "orbital_launch_attempt_count": 5
  },
  "infoURLs": [
    {
      "priority": 10,
      "source": null,
      "title": "Live Flight Tracker - Real-Time Flight Tracker Map",
      "description": "The world’s most popular flight tracker. Track planes in real-time on our flight tracker map and get up-to-date flight status & airport information.",
      "feature_image": null,
      "url": "https://www.flightradar24.com/OBT01/26989797",
      "type": null,
      "language": null
    }
  ],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/launcherone_image_20200101110016.jpeg",
  "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/launcherone252_infographic_20210114193003.png",
  "program": [],
  "orbital_launch_attempt_count": 6039,
  "location_launch_attempt_count": 46,
  "pad_launch_attempt_count": 2,
  "agency_launch_attempt_count": 2,
  "orbital_launch_attempt_count_year": 2,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1,
  "pad_turnaround": "P236DT23H48M51S",
  "mission_patches": [],
  "type": "detailed"
}