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

{
    "response_mode": "detailed",
    "id": 142,
    "url": "https://lldev.thespacedevs.com/2.3.0/locations/142/?format=api",
    "name": "Ronald Reagan Ballistic Missile Defense Test Site, Kwajalein Atoll, Marshall Islands",
    "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": 52,
        "name": "Marshall Islands",
        "alpha_2_code": "MH",
        "alpha_3_code": "MHL",
        "nationality_name": "Marshallese",
        "nationality_name_composed": "Marshallese"
    },
    "description": "The Ronald Reagan Ballistic Missile Defense Test Site is a missile test range in Marshall Islands. It covers about 750,000 square miles (1,900,000 km2) and includes rocket launch sites at the Kwajalein Atoll (on multiple islands), Wake Island, and Aur Atoll. It primarily functions as a test facility for U.S. missile defense and space research programs.",
    "image": {
        "id": 2211,
        "name": "Ronald Reagan Ballistic Missile Defense Test Site",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ronald_reagan_b_image_20240919163927.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ronald_reagan_b_image_thumbnail_20240919163927.jpeg",
        "credit": "US Army Space and Missile Defense Command",
        "license": {
            "id": 17,
            "name": "Department of Defense Image Use Policy",
            "priority": 6,
            "link": "https://www.dimoc.mil/resources/limitations/"
        },
        "single_use": true,
        "variants": []
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_142_20200803142511.jpg",
    "longitude": 167.733333,
    "latitude": 8.716667,
    "timezone_name": "Pacific/Tarawa",
    "total_launch_count": 5,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 107,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/107/?format=api",
            "active": true,
            "agencies": [],
            "name": "Omelek Island",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Omelek_Island",
            "map_url": "https://www.google.com/maps?q=9.047861,167.743",
            "latitude": 9.047861,
            "longitude": 167.743,
            "country": {
                "id": 52,
                "name": "Marshall Islands",
                "alpha_2_code": "MH",
                "alpha_3_code": "MHL",
                "nationality_name": "Marshallese",
                "nationality_name_composed": "Marshallese"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_107_20200803143450.jpg",
            "total_launch_count": 5,
            "orbital_launch_attempt_count": 5,
            "fastest_turnaround": "P56DT19H41M"
        }
    ]
}