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

{
    "count": 602,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/spacecraft/?format=api&limit=10&offset=590&ordering=-flights_count",
    "results": [
        {
            "response_mode": "normal",
            "id": 443,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/443/?format=api",
            "name": "X-15-2",
            "serial_number": "56-6671",
            "is_placeholder": false,
            "image": {
                "id": 1918,
                "name": "[AUTO] North American X-15 - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194132.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 0,
            "mission_ends_count": 0,
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "description": "Second X-15 experimental rocket plane.",
            "spacecraft_config": {
                "response_mode": "normal",
                "id": 13,
                "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/13/?format=api",
                "name": "North American X-15",
                "type": {
                    "id": 3,
                    "name": "Spaceplane"
                },
                "agency": {
                    "response_mode": "list",
                    "id": 44,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                    "name": "National Aeronautics and Space Administration",
                    "abbrev": "NASA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                },
                "family": [],
                "in_use": false,
                "image": {
                    "id": 1918,
                    "name": "[AUTO] North American X-15 - image",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg",
                    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194132.jpeg",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                }
            },
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 470,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/470/?format=api",
            "name": "Ship 20",
            "serial_number": "S20",
            "is_placeholder": false,
            "image": {
                "id": 1935,
                "name": "[AUTO] Starship - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 0,
            "mission_ends_count": 0,
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "description": "Used for ground testing alongside Booster 4. Ship 20 is now on display at the Starbase Rocket Garden.",
            "spacecraft_config": {
                "response_mode": "normal",
                "id": 26,
                "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/26/?format=api",
                "name": "Starship V1",
                "type": {
                    "id": 6,
                    "name": "Reuseable Upper Stage"
                },
                "agency": {
                    "response_mode": "list",
                    "id": 121,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api",
                    "name": "SpaceX",
                    "abbrev": "SpX",
                    "type": {
                        "id": 3,
                        "name": "Commercial"
                    }
                },
                "family": [
                    {
                        "response_mode": "normal",
                        "id": 8,
                        "name": "Starship",
                        "description": "SpaceX Starship upper stages family",
                        "manufacturer": {
                            "response_mode": "list",
                            "id": 121,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api",
                            "name": "SpaceX",
                            "abbrev": "SpX",
                            "type": {
                                "id": 3,
                                "name": "Commercial"
                            }
                        },
                        "parent": null,
                        "maiden_flight": "2023-04-20"
                    }
                ],
                "in_use": false,
                "image": {
                    "id": 1935,
                    "name": "[AUTO] Starship - image",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg",
                    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                }
            },
            "fastest_turnaround": null
        }
    ]
}