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

{
    "response_mode": "detailed",
    "id": 18,
    "url": "https://lldev.thespacedevs.com/2.3.0/locations/18/?format=api",
    "name": "Vostochny Cosmodrome, Siberia, Russian Federation",
    "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": 5,
        "name": "Russia",
        "alpha_2_code": "RU",
        "alpha_3_code": "RUS",
        "nationality_name": "Russian",
        "nationality_name_composed": "Russo"
    },
    "description": "The Vostochny Cosmodrome is a Russian spaceport above the 51st parallel north in the Amur Oblast, in the Russian Far East. It is intended to reduce Russia's dependency on the Baikonur Cosmodrome in Kazakhstan. The first launch took place on 28 April 2016 at 02:01 UTC.",
    "image": {
        "id": 1297,
        "name": "Soyuz 2.1b/Fregat-M liftoff from site 1S (Meteor-M No.2-4 & others)",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20240229134932.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192322.jpeg",
        "credit": "Roscosmos",
        "license": {
            "id": 14,
            "name": "Roscosmos Image Use Policy",
            "priority": 3,
            "link": "https://www.roscosmos.ru/22650/"
        },
        "single_use": false,
        "variants": []
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg",
    "longitude": 128.333932,
    "latitude": 51.884395,
    "timezone_name": "Asia/Yakutsk",
    "total_launch_count": 19,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 83,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/83/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 63,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                    "name": "Russian Federal Space Agency (ROSCOSMOS)",
                    "abbrev": "RFSA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Cosmodrome Site 1S",
            "image": {
                "id": 1297,
                "name": "Soyuz 2.1b/Fregat-M liftoff from site 1S (Meteor-M No.2-4 & others)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20240229134932.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192322.jpeg",
                "credit": "Roscosmos",
                "license": {
                    "id": 14,
                    "name": "Roscosmos Image Use Policy",
                    "priority": 3,
                    "link": "https://www.roscosmos.ru/22650/"
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome",
            "map_url": "https://www.google.com/maps?q=51.884395,128.333932",
            "latitude": 51.884395,
            "longitude": 128.333932,
            "country": {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg",
            "total_launch_count": 18,
            "orbital_launch_attempt_count": 18,
            "fastest_turnaround": "P24DT22H31M45S"
        },
        {
            "id": 108,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/108/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 63,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                    "name": "Russian Federal Space Agency (ROSCOSMOS)",
                    "abbrev": "RFSA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Cosmodrome Site 1A",
            "image": {
                "id": 2063,
                "name": "Angara A5 liftoff from Site 1A (Testflight)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara_a5_lifto_image_20240411095331.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara_a5_lifto_image_thumbnail_20240411095331.jpeg",
                "credit": "ROSCOSMOS",
                "license": {
                    "id": 14,
                    "name": "Roscosmos Image Use Policy",
                    "priority": 3,
                    "link": "https://www.roscosmos.ru/22650/"
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome",
            "map_url": "https://www.google.com/maps?q=51.884395,128.333932",
            "latitude": 51.884395,
            "longitude": 128.333932,
            "country": {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_108_20200803143525.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        }
    ]
}