GET

Celestial Body List

Modes

Levels of detail in the response - list, normal, detailed

Example - /celestial_bodies/?mode=list

Fields searched - name, type__name

Example - /celestial_bodies/?search=Mars

Ordering

Fields - id, name

Example - /celestial_bodies/?ordering=-name

Number of results

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

Example - /celestial_bodies/?limit=2

Format

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

Help

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

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

{
    "count": 4,
    "next": null,
    "previous": null,
    "results": [
        {
            "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-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.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"
        },
        {
            "response_mode": "normal",
            "id": 2,
            "name": "Moon",
            "type": {
                "id": 2,
                "name": "Moon"
            },
            "diameter": 3474800.0,
            "mass": 7.342e+22,
            "gravity": 1.622,
            "length_of_day": "27 07:43:12",
            "atmosphere": false,
            "image": {
                "id": 2041,
                "name": "Moon (Apollo 11)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/moon_2528apoll_image_20240402195408.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/moon_2528apoll_image_thumbnail_20240402195408.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": false,
                "variants": []
            },
            "description": "The Moon is Earth's only natural satellite.",
            "wiki_url": "https://en.wikipedia.org/wiki/Moon"
        },
        {
            "response_mode": "normal",
            "id": 3,
            "name": "Mars",
            "type": {
                "id": 1,
                "name": "Planet"
            },
            "diameter": 6779000.0,
            "mass": 6.4171e+23,
            "gravity": 3.72076,
            "length_of_day": "1 00:37:00",
            "atmosphere": true,
            "image": {
                "id": 2042,
                "name": "Mars",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mars_image_20240402195647.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mars_image_thumbnail_20240402195648.jpeg",
                "credit": "NASA/JPL-Caltech/USGS",
                "license": {
                    "id": 3,
                    "name": "JPL Image Use Policy",
                    "priority": 1,
                    "link": "https://www.jpl.nasa.gov/jpl-image-use-policy"
                },
                "single_use": true,
                "variants": []
            },
            "description": "Mars is the fourth planet from the Sun. The surface of Mars is orange-red because it is covered in iron(III) oxide dust, giving it the nickname \"the Red Planet\".",
            "wiki_url": "https://en.wikipedia.org/wiki/Mars"
        },
        {
            "response_mode": "normal",
            "id": 4,
            "name": "Venus",
            "type": {
                "id": 1,
                "name": "Planet"
            },
            "diameter": 12103600.0,
            "mass": 4.8675e+24,
            "gravity": 8.87,
            "length_of_day": "243 00:32:32",
            "atmosphere": true,
            "image": {
                "id": 2043,
                "name": "Venus",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/venus_image_20240402200108.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/venus_image_thumbnail_20240402200109.jpeg",
                "credit": "NASA/Johns Hopkins University Applied Physics Laboratory/Carnegie Institution of Washington",
                "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": "Venus is the second planet from the Sun. It is a terrestrial planet and is the closest in mass and size to its orbital neighbour Earth. Venus is notable for having the densest atmosphere of the terrestrial planets, composed mostly of carbon dioxide with a thick, global sulfuric acid cloud cover.",
            "wiki_url": "https://en.wikipedia.org/wiki/Venus"
        }
    ]
}