---
title: "The Explorer's Home in one read: Jump back in (the caller's Within reach set: the 4 documents they used on the most days over the last 90, then the 4 they used most recently, none twice; most used first) and What happened (other people's actions on documents the caller can open over the last 14 days, one group per document per day in `tz`). Query: `tz` (IANA, default UTC). 400 `tz_invalid`."
method: GET
path: "/home"
tags: ["Account"]
---

# The Explorer's Home in one read: Jump back in (the caller's Within reach set: the 4 documents they used on the most days over the last 90, then the 4 they used most recently, none twice; most used first) and What happened (other people's actions on documents the caller can open over the last 14 days, one group per document per day in \`tz\`). Query: \`tz\` (IANA, default UTC). 400 \`tz_invalid\`.

`GET /home`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/home`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Response `200`

Success.

- HomeResponse: `GET /api/home`.
  - `jumpBackIn` HomeJumpBackInItem[], required: The server's Within reach set: the most used, then the recent; at most twice the per-row N.
    - `documentId` string, required
    - `empty` boolean, required: Nothing drawn: ask for no thumbnail.
    - `folderId` string, nullable, required: Null for `shared`, and for a document at its space's root.
    - `folderName` string, nullable, required
    - `lastUsedAt` number, required: The later of the person's last open and last real edit: recent.
    - `name` string, required: The document's current name.
    - `ownerName` string, nullable, required
    - `savedAt` number, required: The thumbnail's version.
    - `shareCode` string, nullable, required: The live share code that opens it; set for `shared` only.
    - `tabId` string, nullable, required: The one tab a tab-scoped share opens; null = every tab.
    - `teamId` string, nullable, required: Null for `shared`: the owner's filing is theirs.
    - `teamName` string, nullable, required
    - `useDays` number, required: UTC days in the use window on which the person opened or edited it: most used.
    - `via` 'own' | 'team' | 'shared', required: How the person reaches it: their own, a joined team's, or shared with them by a link.
  - `lastSeenAt` number, nullable, required: The Timeline feed's unread mark as it stood before this read (the read moves it, once per visit); null when the person had never looked. What happened after it is new to them.
  - `whatHappened` HomeGroup[], required
    - `actions` HomeAction[], required: Every action, newest first.
      - `detail` string, nullable, required: The comment's words, the action's name, or the team's name; null for an edit.
      - `id` string, required: The event's id.
      - `occurredAt` number, required
      - `personId` string, required
      - `verb` 'commented' | 'replied' | 'resolved' | 'edited' | 'assigned_you' | 'assigned' | 'completed' | 'shared', required
    - `day` string, required: YYYY-MM-DD in the reader's time zone.
    - `documentId` string, required
    - `empty` boolean, required: Nothing drawn: ask for no thumbnail.
    - `folderId` string, nullable, required: Null for `shared`, and for a document at its space's root.
    - `folderName` string, nullable, required
    - `id` string, required: `<documentId>:<day>`.
    - `latestAt` number, required
    - `name` string, required: The document's current name.
    - `ownerName` string, nullable, required
    - `people` HomePerson[], required: Distinct people, newest action first.
      - `color` string, nullable, required
      - `id` string, required
      - `name` string, nullable, required
      - `pictureUrl` string, nullable, required
    - `savedAt` number, required: The thumbnail's version.
    - `shareCode` string, nullable, required: The live share code that opens it; set for `shared` only.
    - `summary` boolean, required: More than one person acted: one entry with a summary sentence.
    - `tabId` string, nullable, required: The one tab a tab-scoped share opens; null = every tab.
    - `teamId` string, nullable, required: Null for `shared`: the owner's filing is theirs.
    - `teamName` string, nullable, required
    - `total` number, required
    - `verbs` HomeVerbCount[], required: Distinct verbs with their counts, in `HOME_VERBS` order.
      - `count` number, required
      - `verb` 'commented' | 'replied' | 'resolved' | 'edited' | 'assigned_you' | 'assigned' | 'completed' | 'shared', required
    - `via` 'own' | 'team' | 'shared', required: How the person reaches it: their own, a joined team's, or shared with them by a link.

## Other responses

- `400`: Error.
- `401`: Error.
- `429`: Error.

---

[API](https://skmtc.dev/livediagram/apis/livediagram-api.md) · [All operations](https://skmtc.dev/livediagram/apis/livediagram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livediagram/apis/livediagram-api/revisions/f286d27acfd2?raw)