GET

Event Instance

Modes

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

Example - /events/?mode=list

Filters

Parameters - agency__ids, date__gt, date__gt__lt, date__gte, date__lte, day, id, last_updated__gte, last_updated__lte, month, program, slug, 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/1121/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 1121,
    "url": "https://lldev.thespacedevs.com/2.3.0/events/1121/?format=api",
    "name": "Total Lunar Eclipse",
    "info_urls": [
        {
            "priority": 10,
            "source": "science.nasa.gov",
            "title": "What You Need To Know About the March 2025 Total Lunar Eclipse",
            "description": "A total lunar eclipse will tint the Moon red-orange on the night of March 13 or early in the morning of March 14, depending on your time zone.",
            "feature_image": null,
            "url": "https://science.nasa.gov/solar-system/moon/what-you-need-to-know-about-the-march-2025-total-lunar-eclipse/",
            "type": {
                "id": 1,
                "name": "Official Page"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vid_urls": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "Griffith Observatory",
            "title": "TOTAL LUNAR ECLIPSE | MARCH 13, 2025 | GRIFFITH OBSERVATORY",
            "description": "Griffith Observatory is hosting a live online broadcast of the total lunar eclipse on March 13-14 from 8:50 p.m. to 3:05 a.m., PDT, weather permitting. A total lunar eclipse occurs when the Moon passe...",
            "feature_image": "https://i.ytimg.com/vi/BguB5KSBYd0/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=BguB5KSBYd0",
            "type": {
                "id": 3,
                "name": "Unofficial Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2025-03-14T03:50:01Z",
            "end_time": "2025-03-14T10:01:47Z",
            "live": false
        }
    ],
    "image": {
        "id": 1088,
        "name": "[AUTO] Total Lunar Eclipse - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/total_lunar_ecl_image_20221108082109.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.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": "2025-03-14T03:57:00Z",
    "slug": "total-lunar-eclipse-3",
    "type": {
        "id": 11,
        "name": "Celestial Event"
    },
    "description": "The Moon will pass into Earth’s shadow and appear to turn red on the night of March 13 or early in the morning of March 14, depending on time zone.",
    "webcast_live": false,
    "location": "Pacific and America",
    "date_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "response_mode": "detailed",
    "duration": "PT6H3M",
    "updates": [
        {
            "id": 10431,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Unofficial Webcast by Griffith Observatory has started",
            "info_url": "https://www.youtube.com/watch?v=BguB5KSBYd0",
            "created_by": "LL2",
            "created_on": "2025-03-14T03:50:00Z"
        },
        {
            "id": 10038,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding event",
            "info_url": "https://science.nasa.gov/solar-system/moon/what-you-need-to-know-about-the-march-2025-total-lunar-eclipse/",
            "created_by": "Nosu",
            "created_on": "2025-02-07T16:26:00Z"
        }
    ],
    "last_updated": "2025-03-14T10:02:22Z",
    "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": []
}