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

{
    "response_mode": "detailed",
    "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,
    "pads": [
        {
            "id": 105,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/105/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 1001,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1001/?format=api",
                    "name": "EXOS Aerospace",
                    "abbrev": "EXOS",
                    "type": {
                        "id": 3,
                        "name": "Commercial"
                    }
                }
            ],
            "name": "Vertical Launch Area",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=32.9901856,-106.9750602",
            "latitude": 32.9901856,
            "longitude": -106.9750602,
            "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_105_20200803143432.jpg",
            "total_launch_count": 4,
            "orbital_launch_attempt_count": 0,
            "fastest_turnaround": "P118DT23H39M57S"
        }
    ]
}