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

{
    "response_mode": "detailed",
    "id": 26,
    "url": "https://lldev.thespacedevs.com/2.3.0/locations/26/?format=api",
    "name": "Tanegashima Space Center, Japan",
    "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": 28,
        "name": "Japan",
        "alpha_2_code": "JP",
        "alpha_3_code": "JPN",
        "nationality_name": "Japanese",
        "nationality_name_composed": "Nippo"
    },
    "description": "The Tanegashima Space Center is the largest rocket-launch complex in Japan. It is located on the southeastern tip of Tanegashima, an island located south of Kyushu, an island and region and Japan. It was established in 1969 when the National Space Development Agency of Japan (NASDA) was formed, and is now run by JAXA. The activities that take place at TNSC include assembly, testing, launching, and tracking satellites, as well as rocket engine firing tests.",
    "image": {
        "id": 2223,
        "name": "Tanegashima Space Center",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tanegashima_spa_image_20240920081514.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tanegashima_spa_image_thumbnail_20240920081514.jpeg",
        "credit": "JAXA",
        "license": {
            "id": 9,
            "name": "JAXA Image Usage Policy",
            "priority": 8,
            "link": "https://global.jaxa.jp/policy.html"
        },
        "single_use": true,
        "variants": []
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg",
    "longitude": 130.97,
    "latitude": 30.4,
    "timezone_name": "Asia/Tokyo",
    "total_launch_count": 94,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 69,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/69/?format=api",
            "active": true,
            "agencies": [],
            "name": "Unknown Pad",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "",
            "map_url": "https://www.google.com/maps?q=30.401,130.977",
            "latitude": 30.401,
            "longitude": 130.977,
            "country": {
                "id": 28,
                "name": "Japan",
                "alpha_2_code": "JP",
                "alpha_3_code": "JPN",
                "nationality_name": "Japanese",
                "nationality_name_composed": "Nippo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_69_20200803143529.jpg",
            "total_launch_count": 0,
            "orbital_launch_attempt_count": 0,
            "fastest_turnaround": null
        },
        {
            "id": 10,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/10/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 37,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/37/?format=api",
                    "name": "Japan Aerospace Exploration Agency",
                    "abbrev": "JAXA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Osaki Launch Complex",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Tanegashima_Space_Center",
            "map_url": "https://www.google.com/maps?q=30.3993934,130.9702486",
            "latitude": 30.3993934,
            "longitude": 130.9702486,
            "country": {
                "id": 28,
                "name": "Japan",
                "alpha_2_code": "JP",
                "alpha_3_code": "JPN",
                "nationality_name": "Japanese",
                "nationality_name_composed": "Nippo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_10_20200803143519.jpg",
            "total_launch_count": 24,
            "orbital_launch_attempt_count": 24,
            "fastest_turnaround": "P154DT3H37M"
        },
        {
            "id": 41,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/41/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 37,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/37/?format=api",
                    "name": "Japan Aerospace Exploration Agency",
                    "abbrev": "JAXA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yoshinobu Launch Complex LP-1",
            "image": {
                "id": 1520,
                "name": "H-IIA 202 liftoff from LP-1 (IGS Radar 7)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia25202022_image_20240101101918.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193026.jpeg",
                "credit": "Mitsubishi Heavy Industries",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex",
            "map_url": "https://www.google.com/maps?q=30.400813,130.977748",
            "latitude": 30.400813,
            "longitude": 130.977748,
            "country": {
                "id": 28,
                "name": "Japan",
                "alpha_2_code": "JP",
                "alpha_3_code": "JPN",
                "nationality_name": "Japanese",
                "nationality_name_composed": "Nippo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg",
            "total_launch_count": 56,
            "orbital_launch_attempt_count": 56,
            "fastest_turnaround": "P25DT4H54M"
        },
        {
            "id": 209,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/209/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 37,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/37/?format=api",
                    "name": "Japan Aerospace Exploration Agency",
                    "abbrev": "JAXA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yoshinobu Launch Complex LP-2",
            "image": {
                "id": 1751,
                "name": "H-IIB 304 liftoff from LP-2 (HTV-3)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iib_304_lifto_image_20240325125154.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iib_304_lifto_image_thumbnail_20240325125154.jpeg",
                "credit": "JAXA",
                "license": {
                    "id": 9,
                    "name": "JAXA Image Usage Policy",
                    "priority": 8,
                    "link": "https://global.jaxa.jp/policy.html"
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex",
            "map_url": "https://www.google.com/maps?q=30.400938,130.97564",
            "latitude": 30.400938,
            "longitude": 130.97564,
            "country": {
                "id": 28,
                "name": "Japan",
                "alpha_2_code": "JP",
                "alpha_3_code": "JPN",
                "nationality_name": "Japanese",
                "nationality_name_composed": "Nippo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg",
            "total_launch_count": 14,
            "orbital_launch_attempt_count": 14,
            "fastest_turnaround": "P90DT1H42M"
        }
    ]
}