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/0baae9ed-2c61-48b5-919a-d7d1d8c6fe73/?format=api
{ "id": "0baae9ed-2c61-48b5-919a-d7d1d8c6fe73", "url": "https://ll.thespacedevs.com/2.3.0/launches/0baae9ed-2c61-48b5-919a-d7d1d8c6fe73/?format=api", "name": "Lambda 4S | Ohsumi 3", "response_mode": "detailed", "slug": "lambda-4s-ohsumi-3", "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-07-07T13:26:44Z", "net": "1967-04-13T02:40:00Z", "net_precision": null, "window_end": "1967-04-13T02:40:00Z", "window_start": "1967-04-13T02:40:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1009, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1009/?format=api", "name": "Institute of Space and Astronautical Science", "abbrev": "ISAS", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.", "administrator": null, "founding_year": null, "launchers": "Lambda", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 32, "consecutive_successful_launches": 1, "successful_launches": 24, "failed_launches": 8, "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://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "wiki_url": "https://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "social_media_links": [] }, "rocket": { "id": 3643, "configuration": { "response_mode": "detailed", "id": 333, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/333/?format=api", "name": "Lambda 4S", "families": [], "full_name": "Lambda 4S", "variant": "4S", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1009, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1009/?format=api", "name": "Institute of Space and Astronautical Science", "abbrev": "ISAS", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.", "administrator": null, "founding_year": null, "launchers": "Lambda", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 32, "consecutive_successful_launches": 1, "successful_launches": 24, "failed_launches": 8, "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://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "wiki_url": "https://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Lambda_4S", "description": "The Lambda was an experimental Japanese expendable carrier rocket", "alias": "", "min_stage": 4, "max_stage": 4, "length": 16.5, "diameter": 0.74, "maiden_flight": "1966-09-26", "launch_cost": null, "launch_mass": 9.0, "leo_capacity": 26.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 5, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P84DT23H22M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 2061, "name": "Ohsumi 3", "type": "Test Flight", "description": "Ohsumi was a series of five small satellites built to become the first Japanese satellite on orbit.", "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": 43, "url": "https://ll.thespacedevs.com/2.3.0/pads/43/?format=api", "active": true, "agencies": [], "name": "KS Center", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Uchinoura_Space_Center", "map_url": "https://www.google.com/maps?q=31.2519752,131.0791609", "latitude": 31.2519752, "longitude": 131.0791609, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_43_20200803143309.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7, "fastest_turnaround": "P84DT23H22M", "location": { "response_mode": "normal", "id": 24, "url": "https://ll.thespacedevs.com/2.3.0/locations/24/?format=api", "name": "Uchinoura Space Center, Japan", "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": 7149, "successful_launches": 6606, "failed_launches": 543, "total_attempted_landings": 1103, "successful_landings": 1060, "failed_landings": 43 }, "active": true, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "description": "The Uchinoura Space Center is a space launch facility in the Japanese town of Kimotsuki, Kagoshima Prefecture. All of Japan's scientific satellites were launched from Uchinoura prior to the M-V launch vehicles being decommissioned in 2006. It continues to be used for suborbital launches, stratospheric balloons and has also been used for the Epsilon orbital launch vehicle. Additionally, the center has antennas for communication with interplanetary space probes.", "image": { "id": 2225, "name": "Uchinoura Space Center, Japan", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_20240920082429.JPG", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_thumbnail_20240920082429.jpeg", "credit": "Ippukucho", "license": { "id": 19, "name": "CC BY 3.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/3.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_24_20200803142411.jpg", "longitude": 131.081944, "latitude": 31.251944, "timezone_name": "Asia/Tokyo", "total_launch_count": 43, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 685, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 37, "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": "P114DT20M", "mission_patches": [] }
