GET /data_objects/1.0/{id}.json

eol.org:encyclopedia-of-life-api

Summary: Get data object details
Operation ID: getDataObject
Auth: none

Retrieve detailed information about a specific data object (image, video, sound, or text article) from EOL. This endpoint returns metadata about the media item including its license, creator, source URL, thumbnail URLs, file type, dimensions, and the taxon it represents. Use this when you need to display or reference a specific piece of content found within a species page, such as showing an image with proper attribution.

Original spec description

Retrieve metadata for a specific data object (image, video, sound, or text).

Usage Tips

- The `id` parameter follows the format "EOL-media-{resource_id}-{hash}" (e.g., "EOL-media-30-2b0a8f11a7a4e0c254954e7a2297575d") - Response includes both `mediaURL` (original source) and `eolMediaURL` (EOL hosted version) - License information is provided as a URL to the specific Creative Commons or other license - Check `vettedStatus` field to see if content is Trusted, Unreviewed, or Untrusted - The `agents` array contains attribution information for proper credit

Parameters (1)

id (string, path, required)

Data object identifier

Examples (1)

TitleTypeURLAction
Get data object details openapi-spec https://eol.org/api/data_objects/1.0/EOL-media-30-2b0a8f11a7a4e0c254954e7a2297575d.json

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 09:31:39.417607 200 620ms