Skip to Content
Recall
REST API

Upcoming

Current facts with a due date in the next N days, soonest first.

GET /v1/upcoming

Lists current facts whose due date falls between past_days ago and days ahead, soonest first. See dates and reminders for how dates work.

NameTypeRequiredDefaultLimits
containerstringnoserver default1 to 128 characters
all1, 0, true, falsenofalseEvery container in the workspace instead of one
daysintegerno301 to 366
past_daysintegerno00 to 366. Also facts that came due in the last N days
tzstringnoUTCAn IANA time zone such as Asia/Makassar. Decides what "today" is
limitintegerno2001 to 500
curl "https://recall.zakiego.com/v1/upcoming?container=alice&days=60&tz=Asia/Makassar" \
  -H "Authorization: Bearer $RECALL_KEY"
{
  "container": "alice",
  "today": "2026-11-10",
  "from": "2026-11-10",
  "to": "2027-01-09",
  "memories": [
    {
      "id": "mem_...",
      "container": "alice",
      "fact": "Car insurance with Astra renews",
      "kind": "dynamic",
      "eventDate": null,
      "eventPrecision": null,
      "dueDate": "2026-11-16",
      "duePrecision": "day",
      "daysLeft": 6,
      "createdAt": 1762675200000
    }
  ]
}

Each item is a full memory row (the same fields as GET /v1/memories) plus daysLeft, which is negative for a past-due fact. container is null with all. A month or year due date counts from the first day of its period.

StatusWhen
200The list, possibly empty
400A field out of range, or an unknown time zone
401Missing or revoked key

On this page