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/2/?format=api
{ "response_mode": "detailed", "id": 2, "url": "https://lldev.thespacedevs.com/2.3.0/locations/2/?format=api", "name": "Semnan Space Center, Islamic Republic of Iran", "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": 7129, "successful_launches": 6587, "failed_launches": 542, "total_attempted_landings": 1089, "successful_landings": 1046, "failed_landings": 43 }, "active": true, "country": { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" }, "description": "Semnan Space Center is the primary Iranian spaceport, located 50 km southeast of the city of Semnan in the north of the country.", "image": { "id": 2214, "name": "Simorgh liftoff in July 2017", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/semnan_space_ce_image_20240919164557.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/semnan_space_ce_image_thumbnail_20240919164557.jpeg", "credit": "Tasnim News Agency", "license": { "id": 30, "name": "CC BY 4.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/4.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_2_20200803142458.jpg", "longitude": 53.9221, "latitude": 35.2346, "timezone_name": "Asia/Tehran", "total_launch_count": 15, "total_landing_count": 0, "pads": [ { "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/pads/88/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 34, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/34/?format=api", "name": "Iranian Space Agency", "abbrev": "ISA", "type": { "id": 1, "name": "Government" } } ], "name": "Imam Khomeini Spaceport", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Imam_Khomeini_Spaceport", "map_url": "https://www.google.com/maps?q=35.237005,53.9505", "latitude": 35.237005, "longitude": 53.9505, "country": { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_88_20200803143310.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7, "fastest_turnaround": "P201DT3H30M" }, { "id": 58, "url": "https://lldev.thespacedevs.com/2.3.0/pads/58/?format=api", "active": true, "agencies": [], "name": "Safir Launch Pad", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Semnan_Space_Center#Circular_launch_platform", "map_url": "https://www.google.com/maps?q=35.23462,53.920936", "latitude": 35.23462, "longitude": 53.920936, "country": { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_58_20200803143301.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8, "fastest_turnaround": "P109DT23H56M" } ] }
