Launch Instance
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__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
Search
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 - ll.thespacedevs.com/docs
GET /2.3.0/launches/02c372d4-3bb2-4de3-a676-4cd6cfec9728/?format=api
{ "id": "02c372d4-3bb2-4de3-a676-4cd6cfec9728", "url": "https://ll.thespacedevs.com/2.3.0/launches/02c372d4-3bb2-4de3-a676-4cd6cfec9728/?format=api", "name": "Shavit-2 | Ofeq-4", "response_mode": "detailed", "slug": "shavit-2-ofeq-4", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T03:58:14Z", "net": "1998-01-22T12:56:00Z", "net_precision": null, "window_end": "1998-01-22T12:56:00Z", "window_start": "1998-01-22T12:56:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 35, "url": "https://ll.thespacedevs.com/2.3.0/agencies/35/?format=api", "name": "Israeli Space Agency", "abbrev": "ISA", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 7, "consecutive_successful_launches": 1, "successful_launches": 5, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.gov.il/he/Departments/ministry_of_science_and_technology", "wiki_url": "http://en.wikipedia.org/wiki/Israeli_Space_Agency", "social_media_links": [] }, "rocket": { "id": 6834, "configuration": { "response_mode": "detailed", "id": 110, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/110/?format=api", "name": "Shavit-2", "families": [ { "response_mode": "detailed", "id": 140, "name": "Shavit", "manufacturer": [ { "response_mode": "normal", "id": 95, "url": "https://ll.thespacedevs.com/2.3.0/agencies/95/?format=api", "name": "Israel Aerospace Industries", "abbrev": "IAI", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.iai.co.il/", "wiki_url": "http://en.wikipedia.org/wiki/Israel_Aerospace_Industries", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1988-09-19", "total_launch_count": 12, "consecutive_successful_launches": 6, "successful_launches": 10, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Shavit-2", "variant": "2", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 95, "url": "https://ll.thespacedevs.com/2.3.0/agencies/95/?format=api", "name": "Israel Aerospace Industries", "abbrev": "IAI", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.iai.co.il/", "wiki_url": "http://en.wikipedia.org/wiki/Israel_Aerospace_Industries", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Shavit", "description": "N/A", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "1995-04-05", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 10, "consecutive_successful_launches": 6, "successful_launches": 8, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P831DT19H28M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5224, "name": "Ofeq-4", "type": "Government/Top Secret", "description": "Intended for surveillance of Israel's neighbours, the Ofeq series is unusual in having a retrograde orbit. This is due to the geographical location of Israel, which gives only an unobstructed launch path over the mediterranean sea. It is similar to the EROS-A civilian Earth observation satellite. Ofeq 4 (which was possibly the prototype EROS-A satellite) was lost in an launch failure in early 1998.", "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": 75, "url": "https://ll.thespacedevs.com/2.3.0/pads/75/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 95, "url": "https://ll.thespacedevs.com/2.3.0/agencies/95/?format=api", "name": "Israel Aerospace Industries", "abbrev": "IAI", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null } ], "name": "Shavit Launch Pad", "image": { "id": 2207, "name": "Shavit-2 liftoff (Ofek-13)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shavit-2_liftof_image_20240918164729.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shavit-2_liftof_image_thumbnail_20240918164729.jpeg", "credit": "Israel Ministry of Defense", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Palmachim_Airbase", "map_url": "https://www.google.com/maps?q=31.884444,34.680278", "latitude": 31.884444, "longitude": 34.680278, "country": { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_75_20200803143316.jpg", "total_launch_count": 12, "orbital_launch_attempt_count": 12, "fastest_turnaround": "P561DT2H31M", "location": { "response_mode": "normal", "id": 4, "url": "https://ll.thespacedevs.com/2.3.0/locations/4/?format=api", "name": "Palmachim Airbase, State of Israel", "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-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": 7161, "successful_launches": 6618, "failed_launches": 543, "total_attempted_landings": 1110, "successful_landings": 1067, "failed_landings": 43 }, "active": true, "country": { "id": 29, "name": "Israel", "alpha_2_code": "IL", "alpha_3_code": "ISR", "nationality_name": "Israeli", "nationality_name_composed": "Israeli" }, "description": "Palmachim Airbase is an Israeli Air Force (IAF) base and spaceport, which the IAF and the Israel Space Agency (ISA) operate jointly. It is located west of the city of Yavne on the Mediterranean coast, 12 km south of the Gush Dan metropolitan area with Tel Aviv, named after the Kibbutz Palmachim north of it.", "image": { "id": 2207, "name": "Shavit-2 liftoff (Ofek-13)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shavit-2_liftof_image_20240918164729.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shavit-2_liftof_image_thumbnail_20240918164729.jpeg", "credit": "Israel Ministry of Defense", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_4_20200803142418.jpg", "longitude": 34.690556, "latitude": 31.897778, "timezone_name": "Asia/Jerusalem", "total_launch_count": 12, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4210, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 3, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P1023DT1H40M", "mission_patches": [] }
