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

{
  "response_mode": "detailed",
  "id": 144,
  "url": "https://lldev.thespacedevs.com/2.3.0/locations/144/?format=api",
  "name": "Air launch to Suborbital flight",
  "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": 7651,
    "successful_launches": 7094,
    "failed_launches": 557,
    "total_attempted_landings": 1384,
    "successful_landings": 1335,
    "failed_landings": 49
  },
  "active": true,
  "country": {
    "id": 17,
    "name": "Unknown",
    "alpha_2_code": "??",
    "alpha_3_code": "???",
    "nationality_name": "Earthling",
    "nationality_name_composed": "Earthling"
  },
  "description": "",
  "image": {
    "id": 32,
    "name": "[AUTO] Virgin Galactic - image",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg",
    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184711.jpeg",
    "credit": null,
    "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_144_20200803142439.jpg",
  "longitude": null,
  "latitude": null,
  "timezone_name": "",
  "total_launch_count": 86,
  "total_landing_count": 0,
  "pads": [
    {
      "id": 112,
      "url": "https://lldev.thespacedevs.com/2.3.0/pads/112/?format=api",
      "active": true,
      "agencies": [],
      "name": "Edwards Air Force Base",
      "image": null,
      "description": null,
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Edwards_Air_Force_Base",
      "map_url": "https://www.google.com/maps?q=34.905556,-117.883611",
      "latitude": 34.905556,
      "longitude": -117.883611,
      "country": {
        "id": 2,
        "name": "United States of America",
        "alpha_2_code": "US",
        "alpha_3_code": "USA",
        "nationality_name": "American",
        "nationality_name_composed": "Americano"
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_112_20200803143214.jpg",
      "total_launch_count": 13,
      "orbital_launch_attempt_count": 0,
      "fastest_turnaround": "P16DT2H39M"
    },
    {
      "id": 145,
      "url": "https://lldev.thespacedevs.com/2.3.0/pads/145/?format=api",
      "active": true,
      "agencies": [],
      "name": "Naval Air Weapons Station China Lake",
      "image": null,
      "description": null,
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Naval_Air_Weapons_Station_China_Lake",
      "map_url": "https://www.google.com/maps?q=35.6855556,-117.6941384",
      "latitude": 35.6855556,
      "longitude": -117.6941384,
      "country": {
        "id": 2,
        "name": "United States of America",
        "alpha_2_code": "US",
        "alpha_3_code": "USA",
        "nationality_name": "American",
        "nationality_name_composed": "Americano"
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_145_20200803143330.jpg",
      "total_launch_count": 6,
      "orbital_launch_attempt_count": 6,
      "fastest_turnaround": "P1D"
    },
    {
      "id": 190,
      "url": "https://lldev.thespacedevs.com/2.3.0/pads/190/?format=api",
      "active": true,
      "agencies": [
        {
          "response_mode": "list",
          "id": 1024,
          "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
          "name": "Virgin Galactic",
          "abbrev": "VG",
          "type": {
            "id": 5,
            "name": "Private"
          }
        }
      ],
      "name": "Mojave Air and Space Port",
      "image": null,
      "description": null,
      "info_url": "https://www.mojaveairport.com/",
      "wiki_url": "https://en.wikipedia.org/wiki/Mojave_Air_and_Space_Port",
      "map_url": "https://www.google.com/maps?q=35.0594444,-118.1538607",
      "latitude": 35.0594444,
      "longitude": -118.1538607,
      "country": {
        "id": 2,
        "name": "United States of America",
        "alpha_2_code": "US",
        "alpha_3_code": "USA",
        "nationality_name": "American",
        "nationality_name_composed": "Americano"
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_190_20210522160913.jpg",
      "total_launch_count": 53,
      "orbital_launch_attempt_count": 0,
      "fastest_turnaround": "P1D"
    },
    {
      "id": 191,
      "url": "https://lldev.thespacedevs.com/2.3.0/pads/191/?format=api",
      "active": true,
      "agencies": [
        {
          "response_mode": "list",
          "id": 1024,
          "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
          "name": "Virgin Galactic",
          "abbrev": "VG",
          "type": {
            "id": 5,
            "name": "Private"
          }
        }
      ],
      "name": "Spaceport America",
      "image": null,
      "description": null,
      "info_url": "https://www.spaceportamerica.com/",
      "wiki_url": "https://en.wikipedia.org/wiki/Spaceport_America",
      "map_url": "https://www.google.com/maps?q=32.9902778,-106.9719162",
      "latitude": 32.9902778,
      "longitude": -106.9719162,
      "country": {
        "id": 2,
        "name": "United States of America",
        "alpha_2_code": "US",
        "alpha_3_code": "USA",
        "nationality_name": "American",
        "nationality_name_composed": "Americano"
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_spaceport_america_20210522162030.jpg",
      "total_launch_count": 14,
      "orbital_launch_attempt_count": 0,
      "fastest_turnaround": "P26DT23H33M30S"
    }
  ]
}