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 - name, 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 - ll.thespacedevs.com/docs

GET /2.3.0/locations/3/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "response_mode": "detailed",
    "id": 3,
    "url": "https://ll.thespacedevs.com/2.3.0/locations/3/?format=api",
    "name": "Sea Launch",
    "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": 7446,
        "successful_launches": 6892,
        "failed_launches": 554,
        "total_attempted_landings": 1278,
        "successful_landings": 1231,
        "failed_landings": 47
    },
    "active": true,
    "country": {
        "id": 17,
        "name": "Unknown",
        "alpha_2_code": "??",
        "alpha_3_code": "???",
        "nationality_name": "Earthling",
        "nationality_name_composed": "Earthling"
    },
    "description": "",
    "image": {
        "id": 1418,
        "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192712.jpeg",
        "credit": "CASC",
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": false,
        "variants": []
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg",
    "longitude": null,
    "latitude": null,
    "timezone_name": "",
    "total_launch_count": 40,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 147,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/147/?format=api",
            "active": true,
            "agencies": [],
            "name": "Novomoskovsk (K-407)",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Novomoskovsk_(K-407)",
            "map_url": "https://www.google.com/maps?q=74.000000,38.000000",
            "latitude": 74.0,
            "longitude": 38.0,
            "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_147_20200803143422.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 148,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/148/?format=api",
            "active": true,
            "agencies": [],
            "name": "Borisoglebsk (K-496)",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Borisoglebsk_(K-496)",
            "map_url": "https://www.google.com/maps?q=74.0000,38.0000",
            "latitude": 74.0,
            "longitude": 38.0,
            "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_148_20200803143426.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 101,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/101/?format=api",
            "active": true,
            "agencies": [],
            "name": "Unknown Pad",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=0.0,0.0",
            "latitude": null,
            "longitude": null,
            "country": null,
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_101_20200803143204.jpg",
            "total_launch_count": 0,
            "orbital_launch_attempt_count": 0,
            "fastest_turnaround": null
        },
        {
            "id": 149,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/149/?format=api",
            "active": true,
            "agencies": [],
            "name": "Ekaterinburg (K-84)",
            "image": null,
            "description": null,
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Ekaterinburg_(K-84)",
            "map_url": "https://www.google.com/maps?q=74.000000,38.0000",
            "latitude": 74.0,
            "longitude": 38.0,
            "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_149_20200803143409.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 216,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/216/?format=api",
            "active": true,
            "agencies": [],
            "name": "ADD Offshore launch platform",
            "image": {
                "id": 1338,
                "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png",
                "credit": "Yonhap",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "description": "Offshore launch platform for the South Korean military small satellite launch vehicle.",
            "info_url": null,
            "wiki_url": null,
            "map_url": null,
            "latitude": 33.216667,
            "longitude": 126.366667,
            "country": {
                "id": 35,
                "name": "South Korea",
                "alpha_2_code": "KR",
                "alpha_3_code": "KOR",
                "nationality_name": "South Korean",
                "nationality_name_composed": "South Korean"
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_add_offshore_launch_platform_20231204142359.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.3.0/pads/13/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 80,
                    "url": "https://ll.thespacedevs.com/2.3.0/agencies/80/?format=api",
                    "name": "Boeing",
                    "abbrev": "BA",
                    "type": {
                        "id": 3,
                        "name": "Commercial"
                    }
                }
            ],
            "name": "Launch Platform Odyssey",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Odyssey_(launch_platform)",
            "map_url": "https://www.google.com/maps?q=0.0,-154",
            "latitude": 0.0,
            "longitude": -154.0,
            "country": null,
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_13_20200803143257.jpg",
            "total_launch_count": 36,
            "orbital_launch_attempt_count": 36,
            "fastest_turnaround": "P50DT23H36M59S"
        }
    ]
}