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 - lldev.thespacedevs.com/docs

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

{
    "response_mode": "detailed",
    "id": 185,
    "url": "https://lldev.thespacedevs.com/2.3.0/locations/185/?format=api",
    "name": "Haiyang Oriental Spaceport",
    "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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
            "thumbnail_url": "https://thespacedevs-dev.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": 7462,
        "successful_launches": 6908,
        "failed_launches": 554,
        "total_attempted_landings": 1285,
        "successful_landings": 1238,
        "failed_landings": 47
    },
    "active": true,
    "country": {
        "id": 6,
        "name": "China",
        "alpha_2_code": "CN",
        "alpha_3_code": "CHN",
        "nationality_name": "Chinese",
        "nationality_name_composed": "Sino"
    },
    "description": "Chinese orbital launch vehicle launches supporting sea port located at Haiyang, Shandong Province, with dedicated piers and rocket/payload processing facilities for Chinese launch vehicles’ sea launches, and (as part of its expansion project) land based launch pads on artificial islands for various test vehicles and launch vehicles of private and government launch services providers.\r\n\r\nIn operation as a remote base of Taiyuan Satellite Launch Center since 2019.",
    "image": {
        "id": 1355,
        "name": "Gravity-1 liftoff from Haiyang Spaceport (Maiden flight)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192513.jpeg",
        "credit": "OrienSpace",
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg",
    "longitude": 121.235103,
    "latitude": 36.676794,
    "timezone_name": "Asia/Shanghai",
    "total_launch_count": 24,
    "total_landing_count": 0,
    "pads": [
        {
            "id": 217,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/217/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "South China Sea (launch location 1)",
            "image": {
                "id": 1407,
                "name": "Smart Dragon 3 liftoff from Bo Run Jiu Zhou (9 satellites)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/smart2520drago_image_20240204094625.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192650.jpeg",
                "credit": "China Daily/Chen Xiaolong",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=21.283333,112.0",
            "latitude": 21.283333,
            "longitude": 112.0,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_bo_run_jiu_zhou_mobile_launch_platform_20231206001303.jpg",
            "total_launch_count": 2,
            "orbital_launch_attempt_count": 2,
            "fastest_turnaround": "P20DT3H15M"
        },
        {
            "id": 186,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/186/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yellow Sea (launch location 1)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=34.899444,121.190278",
            "latitude": 34.899444,
            "longitude": 121.190278,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_long_march_11_launch_platform_20200901183938.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 89,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/89/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Haiyang offshore launch location",
            "image": {
                "id": 1418,
                "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.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": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=36.631333,121.198361",
            "latitude": 36.631333,
            "longitude": 121.198361,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_89_20200803143242.jpg",
            "total_launch_count": 9,
            "orbital_launch_attempt_count": 9,
            "fastest_turnaround": "P25DT21H9M"
        },
        {
            "id": 212,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/212/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Unknown launch location",
            "image": {
                "id": 1355,
                "name": "Gravity-1 liftoff from Haiyang Spaceport (Maiden flight)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192513.jpeg",
                "credit": "OrienSpace",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=36.676794,121.235103",
            "latitude": 36.676794,
            "longitude": 121.235103,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_haiyang_spaceport_20230827174240.jpg",
            "total_launch_count": 0,
            "orbital_launch_attempt_count": 0,
            "fastest_turnaround": null
        },
        {
            "id": 144,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/144/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yellow Sea (launch location 2)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=34.311667,123.761111",
            "latitude": 34.311667,
            "longitude": 123.761111,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_144_20200803143251.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 221,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/221/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Rizhao offshore launch location",
            "image": {
                "id": 2645,
                "name": "Smart Dragon 3 Launch (Geely Constellation Group 06)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/smart_dragon_3__image_20260116125655.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/smart_dragon_3__image_thumbnail_20260116125656.jpeg",
                "credit": "CASC",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": false,
                "variants": []
            },
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=35.391667,119.598667",
            "latitude": 35.391667,
            "longitude": 119.598667,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_oriental_spaceport_mobile_launch_ship_20240529085416.jpg",
            "total_launch_count": 7,
            "orbital_launch_attempt_count": 7,
            "fastest_turnaround": "P15DT12H8M"
        },
        {
            "id": 248,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/248/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yellow Sea (launch location 3)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=32.183333,123.8",
            "latitude": 32.183333,
            "longitude": 123.8,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_yellow_sea_2528launch_location_32529_20260116130314.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 249,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/249/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "Yellow Sea (launch location 4)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=37.3395,123.7115",
            "latitude": 37.3395,
            "longitude": 123.7115,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_yellow_sea_2528launch_location_42529_20260116130402.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 250,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/250/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "South China Sea (launch location 2)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=21.566667,112.033333",
            "latitude": 21.566667,
            "longitude": 112.033333,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_south_china_sea_2528launch_location_22529_20260116130455.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        },
        {
            "id": 251,
            "url": "https://lldev.thespacedevs.com/2.3.0/pads/251/?format=api",
            "active": true,
            "agencies": [
                {
                    "response_mode": "list",
                    "id": 88,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
                    "name": "China Aerospace Science and Technology Corporation",
                    "abbrev": "CASC",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                }
            ],
            "name": "South China Sea (launch location 3)",
            "image": null,
            "description": "",
            "info_url": null,
            "wiki_url": null,
            "map_url": "https://www.google.com/maps?q=21.366667,112.116667",
            "latitude": 21.366667,
            "longitude": 112.116667,
            "country": {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_south_china_sea_2528launch_location_32529_20260116130538.jpg",
            "total_launch_count": 1,
            "orbital_launch_attempt_count": 1,
            "fastest_turnaround": null
        }
    ]
}