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

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/?format=api&offset=60&ordering=total_landing_count
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 66,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/locations/?format=api&limit=10&offset=50&ordering=total_landing_count",
    "results": [
        {
            "response_mode": "normal",
            "id": 31,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/31/?format=api",
            "name": "Spaceport America, NM, 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": 7129,
                "successful_launches": 6587,
                "failed_launches": 542,
                "total_attempted_landings": 1089,
                "successful_landings": 1046,
                "failed_landings": 43
            },
            "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": "Spaceport America is an FAA-licensed spaceport located in the Jornada del Muerto desert basin north of Las Cruces, New Mexico, and southeast of Truth or Consequences. With Virgin Galactic's launch of the VSS Unity, with three people aboard, on May 22, 2021, New Mexico became the third US state to launch humans into space after California and Florida.",
            "image": {
                "id": 2217,
                "name": "Spaceport America",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_20240919165536.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_thumbnail_20240919165536.jpeg",
                "credit": "Land Rover MENA",
                "license": {
                    "id": 28,
                    "name": "CC BY 2.0",
                    "priority": 6,
                    "link": "https://creativecommons.org/licenses/by/2.0/"
                },
                "single_use": false,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_31_20200803142505.jpg",
            "longitude": -106.969722,
            "latitude": 32.990278,
            "timezone_name": "America/Denver",
            "total_launch_count": 4,
            "total_landing_count": 4
        },
        {
            "response_mode": "normal",
            "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": 7129,
                "successful_launches": 6587,
                "failed_launches": 542,
                "total_attempted_landings": 1089,
                "successful_landings": 1046,
                "failed_landings": 43
            },
            "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": 17,
            "total_landing_count": 13
        },
        {
            "response_mode": "normal",
            "id": 10,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/10/?format=api",
            "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand",
            "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": 51,
                "name": "New Zealand",
                "alpha_2_code": "NZ",
                "alpha_3_code": "NZL",
                "nationality_name": "Kiwi",
                "nationality_name_composed": "Kiwi"
            },
            "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.",
            "image": {
                "id": 2206,
                "name": "Rocket Lab Launch Complex 1",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_20240918164228.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_thumbnail_20240918164228.jpeg",
                "credit": "Rocket Lab",
                "license": {
                    "id": 7,
                    "name": "Rocket Lab Image Use Policy",
                    "priority": 3,
                    "link": "https://www.rocketlabusa.com/about/gallery/"
                },
                "single_use": true,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg",
            "longitude": 177.86586,
            "latitude": -39.26085,
            "timezone_name": "Pacific/Auckland",
            "total_launch_count": 57,
            "total_landing_count": 17
        },
        {
            "response_mode": "normal",
            "id": 11,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/11/?format=api",
            "name": "Vandenberg SFB, CA, 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": 7129,
                "successful_launches": 6587,
                "failed_launches": 542,
                "total_attempted_landings": 1089,
                "successful_landings": 1046,
                "failed_landings": 43
            },
            "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": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.",
            "image": {
                "id": 2226,
                "name": "Vandenberg SFB imaged by Sentinel-2",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_20240920082910.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_thumbnail_20240920082910.jpeg",
                "credit": "Contains modified Copernicus Sentinel data 2020",
                "license": {
                    "id": 33,
                    "name": "Copernicus Image Use Policy",
                    "priority": 0,
                    "link": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32013R1159"
                },
                "single_use": true,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg",
            "longitude": -120.52023,
            "latitude": 34.75133,
            "timezone_name": "America/Los_Angeles",
            "total_launch_count": 800,
            "total_landing_count": 26
        },
        {
            "response_mode": "normal",
            "id": 29,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/29/?format=api",
            "name": "Corn Ranch, Van Horn, 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": 7129,
                "successful_launches": 6587,
                "failed_launches": 542,
                "total_attempted_landings": 1089,
                "successful_landings": 1046,
                "failed_landings": 43
            },
            "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": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.",
            "image": {
                "id": 2098,
                "name": "New Shepard liftoff (NS-25)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
            "longitude": -104.757152,
            "latitude": 31.422927,
            "timezone_name": "America/Chicago",
            "total_launch_count": 30,
            "total_landing_count": 30
        },
        {
            "response_mode": "normal",
            "id": 12,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/12/?format=api",
            "name": "Cape Canaveral SFS, FL, 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": 7129,
                "successful_launches": 6587,
                "failed_launches": 542,
                "total_attempted_landings": 1089,
                "successful_landings": 1046,
                "failed_landings": 43
            },
            "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": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
            "image": {
                "id": 2200,
                "name": "Cape Canaveral & KSC seen from orbit (STS-43)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
            "longitude": -80.577778,
            "latitude": 28.488889,
            "timezone_name": "America/New_York",
            "total_launch_count": 1014,
            "total_landing_count": 62
        }
    ]
}