Browse recordings on a timeline
Turn availability data into a scrubbable history and pull any moment back.
Evercam does not hand you a video stream of the past. It tells you which periods hold images, and lets you fetch the snapshot nearest any moment. Those two ideas are enough to build a scrubbable timeline.
1. Which days have recordings
The days in a month holding at least one snapshot.
curl -H "Authorization: Bearer $EVERCAM_TOKEN" \
"https://media.evercam.io/v2/cameras/$CAMERA_ID/recordings/snapshots/2026/8/days"{ "days": [1, 5, 13, 27] }2. Which hours within a day
The hours of one day holding snapshots.
{ "hours": [10, 11, 15, 18] }Both are plain integer arrays in the camera's timezone. Render them as enabled cells and everything else as disabled — that alone is a usable timeline.
3. Fetch the moment
The stored snapshot closest to a given time.
The timestamp is ISO 8601, and must be URL-encoded
Use 2026-08-01T09:00:00.000+00:00, not a compact form like
20260801T090000Z — the compact form returns 400 Bad Request. Because the
value contains : and +, encode it before putting it in the path.
TS=$(python3 -c "import urllib.parse;print(urllib.parse.quote('2026-08-01T09:00:00.000+00:00', safe=''))")
curl -H "Authorization: Bearer $EVERCAM_TOKEN" \
"https://media.evercam.io/v2/cameras/$CAMERA_ID/recordings/snapshots/$TS/nearest"The response wraps a single snapshot in a snapshots array; each entry has the
same data and created_at fields as the latest-snapshot endpoint.
Try it
Next
Generate or retrieve a timelapse to compress a long period into a few seconds of video.