Location Instance
Modes
Levels of detail in the response - normal, detailed
Example - /locations/?mode=detailed
Filters
Parameters - active, country_code, id, name, name__contains, total_landing_count, total_landing_count__gt, total_landing_count__gte, total_landing_count__lt, total_landing_count__lte, total_launch_count, total_launch_count__gt, total_launch_count__gte, total_launch_count__lt, total_launch_count__lte
Example - /locations/?country_code=NZL
Search
Fields searched - country__alpha_3_code, name
Example - /locations/?search=Cape Canaveral
Ordering
Fields - total_landing_count, total_launch_count
Example - /locations/?ordering=-total_launch_count
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /locations/?limit=2
Format
Switch to JSON output - /locations/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/locations/143/?format=api
{ "response_mode": "detailed", "id": 143, "url": "https://lldev.thespacedevs.com/2.3.0/locations/143/?format=api", "name": "SpaceX Starbase, TX, USA", "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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "description": "Starbase is an industrial complex for Starship rockets and the headquarters of the American aerospace manufacturer company SpaceX. Located near Brownsville, Texas, United States, it has been under construction since the late 2010s by SpaceX. Starbase is composed of a spaceport near the Gulf of Mexico, a production facility at the Boca Chica village, and a small structure test site along the Texas State Highway 4.", "image": { "id": 2219, "name": "SpaceX Starbase in March 2022", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_starbase_image_20240919170357.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_starbase_image_thumbnail_20240919170357.jpeg", "credit": "SpaceX", "license": { "id": 5, "name": "CC BY-NC 2.0", "priority": 1, "link": "https://creativecommons.org/licenses/by-nc/2.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg", "longitude": -97.157, "latitude": 25.997, "timezone_name": "America/Chicago", "total_launch_count": 18, "total_landing_count": 13, "pads": [ { "id": 188, "url": "https://lldev.thespacedevs.com/2.3.0/pads/188/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } } ], "name": "Orbital Launch Mount A", "image": null, "description": "The first launch and landing pad of the full version of the combined SpaceX Starship and Superheavy booster. First used for launch in April 2023.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starbase#Launch_site_(Orbital_Launch_Pad_A_and_B)", "map_url": "https://www.google.com/maps?q=25.9962,-97.154423", "latitude": 25.9962, "longitude": -97.154423, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_orbital_launch_mount_a_20210514061342.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P37DT9H35M" }, { "id": 235, "url": "https://lldev.thespacedevs.com/2.3.0/pads/235/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } } ], "name": "Orbital Launch Mount B", "image": null, "description": "The second launch and landing pad of the full version of the combined SpaceX Starship and Superheavy booster. To be first used for launch in 2025.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starbase#Launch_site_(Orbital_Launch_Pad_A_and_B)", "map_url": "https://www.google.com/maps?q=25.996603,-97.158251", "latitude": 25.996603, "longitude": -97.158251, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_orbital_launch_mount_b_20241126031254.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null }, { "id": 111, "url": "https://lldev.thespacedevs.com/2.3.0/pads/111/?format=api", "active": false, "agencies": [ { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } } ], "name": "Suborbital Pad A", "image": null, "description": "Suborbital Pad A was used for Starhopper flights, the SN5 and SN6 hops, as well as multiple Starship high altitude flight tests. It was demolished at the end of 2023, to make room for a second orbital pad.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_South_Texas_Launch_Site", "map_url": "https://www.google.com/maps?q=25.997116,-97.15503099856647", "latitude": 25.997116, "longitude": -97.15503099856647, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_111_20200803143229.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P29DT17H51M" }, { "id": 187, "url": "https://lldev.thespacedevs.com/2.3.0/pads/187/?format=api", "active": false, "agencies": [ { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } } ], "name": "Suborbital Pad B", "image": null, "description": "Suborbital Pad B was used for 2 Starship high altitude flight tests. It is now being used for static fire tests", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_South_Texas_Launch_Site", "map_url": "https://www.google.com/maps?q=25.997116,-97.15503099856647", "latitude": 25.997116, "longitude": -97.15503099856647, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_pad_b_20201211004226.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P55DT16H34M45S" } ] }
