GET

Spacecraft List

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

{
    "count": 601,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/spacecraft/?format=api&limit=10&offset=590&ordering=-mission_ends_count",
    "results": [
        {
            "response_mode": "normal",
            "id": 616,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/616/?format=api",
            "name": "Soyuz MS-29",
            "serial_number": "11F732 #760",
            "is_placeholder": false,
            "image": {
                "id": 967,
                "name": "Soyuz MS in orbit (MS-19)",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg",
                "credit": "ESA/NASA/T. Pesquet",
                "license": {
                    "id": 2,
                    "name": "ESA Standard Licence",
                    "priority": 2,
                    "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                },
                "single_use": false,
                "variants": []
            },
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 0,
            "mission_ends_count": 0,
            "status": {
                "id": 4,
                "name": "Single Use"
            },
            "description": "Soyuz capsule for the MS-29 mission to the ISS.",
            "spacecraft_config": {
                "response_mode": "normal",
                "id": 38,
                "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/38/?format=api",
                "name": "Soyuz MS",
                "type": {
                    "id": 2,
                    "name": "Capsule"
                },
                "agency": {
                    "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"
                    }
                },
                "family": [
                    {
                        "response_mode": "normal",
                        "id": 1,
                        "name": "Soyuz",
                        "description": "Soyuz is a series of spacecraft which has been in service since the 1960s, having made more than 140 flights. It was designed for the Soviet space program by the Korolev Design Bureau (now Energia).",
                        "manufacturer": {
                            "response_mode": "list",
                            "id": 1000,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1000/?format=api",
                            "name": "Energia",
                            "abbrev": "OKB-1",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        "parent": null,
                        "maiden_flight": "1966-11-28"
                    }
                ],
                "in_use": true,
                "image": {
                    "id": 967,
                    "name": "Soyuz MS in orbit (MS-19)",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg",
                    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg",
                    "credit": "ESA/NASA/T. Pesquet",
                    "license": {
                        "id": 2,
                        "name": "ESA Standard Licence",
                        "priority": 2,
                        "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website"
                    },
                    "single_use": false,
                    "variants": []
                }
            },
            "fastest_turnaround": null
        }
    ]
}