Modes

Levels of detail in the response - normal, detailed

Example - /spacecraft/?mode=detailed

Filters

Parameters - in_space, is_placeholder, name, spacecraft_config, status

Example - /spacecraft/?is_placeholder=True

Fields searched - name, spacecraft_config__name

Example - /spacecraft/?search=Endeavour

Ordering

Fields - flights_count, id, mission_ends_count, time_docked, time_in_space

Example - /spacecraft/?ordering=-flights_count

Number of results

Use limit to control the number of objects in the response (max 100)

Example - /spacecraft/?limit=2

Format

Switch to JSON output - /spacecraft/?format=json

Help

Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs

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

{
  "response_mode": "detailed",
  "id": 560,
  "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/560/?format=api",
  "name": "Chinese Reusable Space Vehicle",
  "serial_number": null,
  "is_placeholder": false,
  "image": null,
  "in_space": true,
  "time_in_space": "P811DT11H24M38S",
  "time_docked": "P0D",
  "flights_count": 4,
  "mission_ends_count": 3,
  "status": {
    "id": 1,
    "name": "Active"
  },
  "description": "First Chinese reusable spacecraft, apparently a spaceplane with wings per a photo taken by a US satellite. No public information of it is available.\r\n\r\nIts official name is \"Chongfu Shiyong Shiyan Hangtian Qi\", meaning \"Reusable Experimental Spacecraft\".\r\n\r\nNote: It is unknown how many flight vehicles have been built and flown.",
  "spacecraft_config": {
    "response_mode": "detailed",
    "id": 31,
    "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/31/?format=api",
    "name": "Chinese Reusable Space Vehicle",
    "type": {
      "id": 3,
      "name": "Spaceplane"
    },
    "agency": {
      "response_mode": "normal",
      "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"
      },
      "featured": true,
      "country": [
        {
          "id": 6,
          "name": "China",
          "alpha_2_code": "CN",
          "alpha_3_code": "CHN",
          "nationality_name": "Chinese",
          "nationality_name_composed": "Sino"
        }
      ],
      "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
      "administrator": "Chairman & President: Lei Fanpei",
      "founding_year": 1999,
      "launchers": "Long March",
      "spacecraft": "",
      "parent": null,
      "image": {
        "id": 8,
        "name": "[AUTO] China Aerospace Science and Technology Corporation - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "logo": {
        "id": 124,
        "name": "[AUTO] China Aerospace Science and Technology Corporation - logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "social_logo": {
        "id": 50,
        "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      }
    },
    "family": [],
    "in_use": true,
    "image": null,
    "capability": "Reusable technology demonstration test bed for orbital and re-entry operations.",
    "history": "First launched on September 4, 2020 and landed two days later. Launched again on August 4, 2022.",
    "details": "The Chinese reusable experimental spacecraft is the first Chinese reusable spacecraft.",
    "maiden_flight": "2020-09-04",
    "height": null,
    "diameter": null,
    "human_rated": false,
    "crew_capacity": null,
    "payload_capacity": null,
    "payload_return_capacity": null,
    "flight_life": "Multiple months",
    "wiki_link": "https://en.wikipedia.org/wiki/Chinese_reusable_experimental_spacecraft",
    "info_link": "",
    "spacecraft_flown": 1,
    "total_launch_count": 4,
    "successful_launches": 4,
    "failed_launches": 0,
    "attempted_landings": 3,
    "successful_landings": 3,
    "failed_landings": 0,
    "fastest_turnaround": "P220DT13H52M"
  },
  "fastest_turnaround": "P220DT13H52M",
  "flights": [
    {
      "id": 903,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_flights/903/?format=api",
      "destination": "Low Earth Orbit",
      "mission_end": null,
      "spacecraft": {
        "response_mode": "normal",
        "id": 560,
        "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/560/?format=api",
        "name": "Chinese Reusable Space Vehicle",
        "serial_number": null,
        "is_placeholder": false,
        "image": null,
        "in_space": true,
        "time_in_space": "P811DT11H24M38S",
        "time_docked": "P0D",
        "flights_count": 4,
        "mission_ends_count": 3,
        "status": {
          "id": 1,
          "name": "Active"
        },
        "description": "First Chinese reusable spacecraft, apparently a spaceplane with wings per a photo taken by a US satellite. No public information of it is available.\r\n\r\nIts official name is \"Chongfu Shiyong Shiyan Hangtian Qi\", meaning \"Reusable Experimental Spacecraft\".\r\n\r\nNote: It is unknown how many flight vehicles have been built and flown.",
        "spacecraft_config": {
          "response_mode": "normal",
          "id": 31,
          "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/31/?format=api",
          "name": "Chinese Reusable Space Vehicle",
          "type": {
            "id": 3,
            "name": "Spaceplane"
          },
          "agency": {
            "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"
            }
          },
          "family": [],
          "in_use": true,
          "image": null
        },
        "fastest_turnaround": "P220DT13H52M"
      },
      "launch": {
        "id": "a9fd7757-9a51-4607-845d-d830673c4486",
        "url": "https://lldev.thespacedevs.com/2.3.0/launches/a9fd7757-9a51-4607-845d-d830673c4486/?format=api",
        "name": "Long March 2F/G | Chinese Reusable Space Vehicle",
        "response_mode": "normal",
        "slug": "long-march-2fg-chinese-reusable-space-vehicle-4",
        "launch_designator": "2026-024",
        "status": {
          "id": 3,
          "name": "Launch Successful",
          "abbrev": "Success",
          "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
        },
        "last_updated": "2026-11-01T01:39:53Z",
        "net": "2026-02-07T03:58:00Z",
        "net_precision": {
          "id": 1,
          "name": "Minute",
          "abbrev": "MIN",
          "description": "The T-0 is accurate to the minute."
        },
        "window_end": "2026-02-07T04:07:00Z",
        "window_start": "2026-02-07T03:48:00Z",
        "image": {
          "id": 2580,
          "name": "Shenzhou 22 launch",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_20251129175823.jpg",
          "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_thumbnail_20251129175823.jpeg",
          "credit": "Xinhua",
          "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
          },
          "single_use": true,
          "variants": []
        },
        "infographic": null,
        "probability": null,
        "weather_concerns": null,
        "failreason": "",
        "hashtag": null,
        "launch_service_provider": {
          "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"
          }
        },
        "rocket": {
          "id": 8911,
          "configuration": {
            "response_mode": "list",
            "id": 84,
            "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/84/?format=api",
            "name": "Long March 2F/G",
            "families": [
              {
                "response_mode": "list",
                "id": 106,
                "name": "Long March"
              },
              {
                "response_mode": "list",
                "id": 109,
                "name": "Long March 2"
              }
            ],
            "full_name": "Long March 2F/G",
            "variant": "F/G"
          }
        },
        "mission": {
          "id": 7502,
          "name": "Chinese Reusable Space Vehicle",
          "type": "Government/Top Secret",
          "description": "4th flight of the Chinese spaceplane capable of returning to Earth.",
          "image": null,
          "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO",
            "celestial_body": {
              "response_mode": "list",
              "id": 1,
              "name": "Earth"
            }
          },
          "agencies": [],
          "info_urls": [],
          "vid_urls": []
        },
        "pad": {
          "id": 37,
          "url": "https://lldev.thespacedevs.com/2.3.0/pads/37/?format=api",
          "active": true,
          "agencies": [],
          "name": "Launch Area 91 (SLS-1 / 921)",
          "image": {
            "id": 1363,
            "name": "Long March 2F/G from LA-4 (Shenzhou 17)",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20231231163528.jpeg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192527.jpeg",
            "credit": "我们的太空",
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": false,
            "variants": []
          },
          "description": "",
          "info_url": null,
          "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4",
          "map_url": "https://www.google.com/maps?q=40.957893,100.290944",
          "latitude": 40.957893,
          "longitude": 100.290944,
          "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_37_20200803143603.jpg",
          "total_launch_count": 29,
          "orbital_launch_attempt_count": 29,
          "fastest_turnaround": "P24DT12H26M59S",
          "location": {
            "response_mode": "normal",
            "id": 17,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api",
            "name": "Jiuquan Satellite Launch Center, People's Republic of China",
            "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": 6,
              "name": "China",
              "alpha_2_code": "CN",
              "alpha_3_code": "CHN",
              "nationality_name": "Chinese",
              "nationality_name_composed": "Sino"
            },
            "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
            "image": {
              "id": 1374,
              "name": "Long March 2F/G liftoff (Shenzhou 16)",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg",
              "credit": "CMS",
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": false,
              "variants": []
            },
            "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
            "longitude": 100.291111,
            "latitude": 40.958056,
            "timezone_name": "Asia/Shanghai",
            "total_launch_count": 300,
            "total_landing_count": 3
          }
        },
        "webcast_live": false,
        "program": [],
        "orbital_launch_attempt_count": 7200,
        "location_launch_attempt_count": 277,
        "pad_launch_attempt_count": 28,
        "agency_launch_attempt_count": 577,
        "orbital_launch_attempt_count_year": 27,
        "location_launch_attempt_count_year": 4,
        "pad_launch_attempt_count_year": 1,
        "agency_launch_attempt_count_year": 7
      },
      "landing": {
        "id": 1810,
        "url": "https://lldev.thespacedevs.com/2.3.0/landings/1810/?format=api",
        "attempt": false,
        "success": null,
        "description": "The reusable space plane will land on the Lop Nur dried salt lake.",
        "downrange_distance": null,
        "landing_location": {
          "id": 30,
          "name": "Lop Nur Airbase",
          "active": true,
          "abbrev": "LNA",
          "description": "Military airbase located on a dried salt lake in the Xinjiang Uygur Autonomous Region, China.",
          "location": null,
          "longitude": 89.28202039,
          "latitude": 40.77287097,
          "image": {
            "id": 2237,
            "name": "Lop Nur Airbase",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/lop_nur_airbase_image_20240920092126.jpg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/lop_nur_airbase_image_thumbnail_20240920092126.jpeg",
            "credit": "Planet Labs",
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": true,
            "variants": []
          },
          "successful_landings": 3,
          "attempted_landings": 3,
          "failed_landings": 0,
          "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"
          }
        },
        "type": {
          "id": 6,
          "name": "Horizontal Landing",
          "abbrev": "HL",
          "description": "Horizontal landing on a runway or flat surface."
        }
      },
      "duration": "P266DT21H41M52.975449S",
      "turn_around_time": "P519DT2H48M",
      "response_mode": "normal"
    }
  ]
}