GET

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

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

{
    "response_mode": "detailed",
    "id": 155,
    "url": "https://lldev.thespacedevs.com/2.3.0/locations/155/?format=api",
    "name": "White Sands Missile Range",
    "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": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.",
    "image": {
        "id": 2229,
        "name": "Space Shuttle Columbia landing at White Sands (STS-3)",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_c_image_20240920084425.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_c_image_thumbnail_20240920084425.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": false,
        "variants": []
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg",
    "longitude": -106.405833,
    "latitude": 32.335556,
    "timezone_name": "America/Denver",
    "total_launch_count": 5,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 194,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/194/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 165,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/165/?format=api",
                    "name": "US Army",
                    "abbrev": "USA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Launch Complex 36",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/White_Sands_Launch_Complex_36",
            "map_url": "https://www.google.com/maps?q=32.416944,-106.321944",
            "latitude": 32.416944,
            "longitude": -106.321944,
            "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_complex_36_20210901072730.jpg",
            "total_launch_count": 5,
            "orbital_launch_attempt_count": 0,
            "fastest_turnaround": "P161DT22H1M4S"
        }
    ]
}