GET

Event Instance

Modes

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

Example - /events/?mode=list

Filters

Parameters - agency__ids, date__gt, date__gte, date__lt, date__lte, day, expedition__ids, id, last_updated__gte, last_updated__lte, launch__ids, month, program, program__ids, slug, spacestation__ids, type, type__ids, video_url, year

Example - /events/?type__ids=2,8

Fields searched - name

Example - /events/?search=Flyby

Ordering

Fields - date, last_updated

Example - /events/?ordering=-last_updated

Number of results

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

Example - /events/?limit=2

Format

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

Help

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

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

{
    "id": 1328,
    "url": "https://lldev.thespacedevs.com/2.3.0/events/1328/?format=api",
    "name": "Total Lunar Eclipse",
    "info_urls": [
        {
            "priority": 10,
            "source": "science.nasa.gov",
            "title": "March 2026 Total Lunar Eclipse: Your Questions Answered",
            "description": "A total lunar eclipse will redden the Moon on March 3, 2026. Here’s what you need to know.",
            "feature_image": null,
            "url": "https://science.nasa.gov/solar-system/moon/march-2026-total-lunar-eclipse-your-questions-answered/",
            "type": {
                "id": 1,
                "name": "Official Page"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vid_urls": [],
    "image": {
        "id": 1088,
        "name": "[AUTO] Total Lunar Eclipse - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/total_lunar_ecl_image_20221108082109.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191610.jpeg",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "date": "2026-03-03T11:04:00Z",
    "slug": "total-lunar-eclipse-4",
    "type": {
        "id": 11,
        "name": "Celestial Event"
    },
    "description": "The Moon will pass into Earth’s shadow and appear to turn red on March 3, 2026.\r\n\r\nTotality will be visible in the evening from eastern Asia and Australia, throughout the night in the Pacific, and in the early morning in North and Central America and far western South America. The eclipse is partial in central Asia and much of South America. No eclipse is visible in Africa or Europe.",
    "webcast_live": false,
    "location": "Eastern Asia, Australia, Pacific, North and South America",
    "date_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "response_mode": "detailed",
    "duration": "PT59M",
    "updates": [
        {
            "id": 13858,
            "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding event",
            "info_url": "https://science.nasa.gov/solar-system/moon/march-2026-total-lunar-eclipse-your-questions-answered/",
            "created_by": "Nosu",
            "created_on": "2026-02-02T07:41:00Z"
        }
    ],
    "last_updated": "2026-02-02T07:41:46Z",
    "agencies": [
        {
            "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"
            }
        }
    ],
    "launches": [],
    "expeditions": [],
    "spacestations": [],
    "program": [],
    "astronauts": []
}