GET

Launch Instance

API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch// 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'

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.0.0/launch/34e353dc-a3a9-4396-96f9-f1c42cd2414d/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "34e353dc-a3a9-4396-96f9-f1c42cd2414d",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/34e353dc-a3a9-4396-96f9-f1c42cd2414d/?format=api",
  "launch_library_id": 1397,
  "slug": "gslv-gsat-3",
  "name": "GSLV | GSAT-3",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2004-09-20T10:31:00Z",
  "window_end": "2004-09-20T10:31:00Z",
  "window_start": "2004-09-20T10:31:00Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": null,
  "hashtag": null,
  "launch_service_provider": {
    "id": 31,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/31/?format=api",
    "name": "Indian Space Research Organization",
    "featured": true,
    "type": "Government",
    "country_code": "IND",
    "abbrev": "ISRO",
    "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
    "administrator": "Chairman: V. Narayanan",
    "founding_year": "1969",
    "launchers": "PSLV | GSLV",
    "spacecraft": "Gaganyaan",
    "launch_library_url": null,
    "total_launch_count": 101,
    "consecutive_successful_launches": 2,
    "successful_launches": 86,
    "failed_launches": 15,
    "pending_launches": 20,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.isro.gov.in/",
    "wiki_url": "https://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
  },
  "rocket": {
    "id": 504,
    "configuration": {
      "id": 5,
      "launch_library_id": 17,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/5/?format=api",
      "name": "GSLV",
      "description": "GSLVGeosynchronous Satellite Launch Vehicle abbreviated as GSLV, is an expendable launch system operated by the Indian Space Research Organisation (ISRO).",
      "family": "GSLV",
      "full_name": "GSLV",
      "manufacturer": {
        "id": 31,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/31/?format=api",
        "name": "Indian Space Research Organization",
        "featured": true,
        "type": "Government",
        "country_code": "IND",
        "abbrev": "ISRO",
        "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"",
        "administrator": "Chairman: V. Narayanan",
        "founding_year": "1969",
        "launchers": "PSLV | GSLV",
        "spacecraft": "Gaganyaan",
        "launch_library_url": null,
        "total_launch_count": 101,
        "consecutive_successful_launches": 2,
        "successful_launches": 86,
        "failed_launches": 15,
        "pending_launches": 20,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.isro.gov.in/",
        "wiki_url": "https://en.wikipedia.org/wiki/Indian_Space_Research_Organization",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg"
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 3,
      "max_stage": 3,
      "length": 49.13,
      "diameter": 2.8,
      "maiden_flight": "2001-04-18",
      "launch_mass": 414,
      "leo_capacity": 5000,
      "gto_capacity": 2500,
      "to_thrust": 4860,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gslv_image_20190604000621.jpg",
      "info_url": null,
      "wiki_url": "http://en.wikipedia.org/wiki/GSLV",
      "total_launch_count": 6,
      "consecutive_successful_launches": 0,
      "successful_launches": 2,
      "failed_launches": 4,
      "pending_launches": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": null,
  "pad": {
    "id": 50,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/50/?format=api",
    "agency_id": 31,
    "name": "Satish Dhawan Space Centre First Launch Pad",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_First_Launch_Pad",
    "map_url": "https://www.google.com/maps?q=13.733,80.235",
    "latitude": "13.733",
    "longitude": "80.235",
    "location": {
      "id": 14,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/14/?format=api",
      "name": "Satish Dhawan Space Centre, India",
      "country_code": "IND",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg",
      "total_launch_count": 106,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_50_20200803143457.jpg",
    "total_launch_count": 64
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gslv_image_20190604000621.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 4676,
  "location_launch_attempt_count": 19,
  "pad_launch_attempt_count": 11,
  "agency_launch_attempt_count": 19,
  "orbital_launch_attempt_count_year": 37,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1
}