---
title: "Get Home"
method: GET
path: "/api/me/home"
tags: ["home"]
---

# Get Home

`GET /api/me/home`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/me/home`
- Auth: none declared

The whole Home report in one request (R9). ``needs_you_full`` lifts
the Needs-you cap so the "and N more" affordance reveals the rest
(TOS-5168).

## Query parameters

- `needs_you_full` boolean

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- HomeReport
  - `window` HomeWindow, required
    - `since` string, date-time, required
    - `until` string, date-time, required
    - `label` string, required
  - `headline` Headline, required
    - `text` string, required
    - `detail` string, required
  - `working` WorkingRun[]
    - `run_id` string, uuid, required
    - `title` string, required
    - `started_at` string, date-time, required
    - `chat_id` string, uuid, nullable
  - `needs_you` NeedGroup[]
    - `kind` 'approve' | 'broken' | 'failed' | 'open' | 'other', required
    - `title` string, required
    - `detail` string, required
    - `count` integer, required
    - `action` NeedAction, required
      - `label` string, required
      - `kind` 'open_chats' | 'reconnect_all' | 'open_run' | 'connect' | 'start_interview' | 'restart_setup' | 'open_notifications' | 'open_marketplace_connections', required
      - `target` string, nullable
    - `dismissible` boolean
    - `key` string, nullable
    - `refs` string[]
    - `connection_slugs` string[]
    - `agent` AgentRef
      - `id` string, uuid, required
      - `name` string, required
      - `avatar_url` string, nullable
  - `needs_you_has_more` boolean
  - `overflow_count` integer
  - `done_for_you` DoneForYouRow[]
    - `id` string, uuid, required
    - `summary` string, required
    - `occurred_at` string, date-time, required
    - `source_kind` string, required
    - `agent` AgentRef
      - `id` string, uuid, required
      - `name` string, required
      - `avatar_url` string, nullable
  - `standing` StandingRow[]
    - `trigger_id` string, uuid, required
    - `job_key` string, required
    - `title` string, required
    - `schedule` string, required
    - `schedule_label` string, required
    - `paused` boolean, required
    - `last` StandingLast
      - `summary` string, required
      - `at` string, date-time, required
  - `learned` LearnedRow[]
    - `proposition_id` string, uuid, required
    - `text` string, required
    - `source_label` string, required
  - `connections` ConnectionRow[]
    - `slug` string, required
    - `name` string, required
    - `icon_url` string, nullable
    - `state` 'live' | 'broken', required
    - `account_label` string, nullable
    - `connection_id` string, uuid, nullable
    - `capability_id` string, uuid, nullable
    - `blocker` 'none' | 'needs_credentials' | 'needs_reconnect'
  - `open_items` OpenItemOut[]
    - `key` string, required
    - `title` string, required
    - `detail` string, required
  - `sections` SectionStatuses
    - `needs_you` 'ok' | 'empty' | 'error'
    - `done_for_you` 'ok' | 'empty' | 'error'
    - `standing` 'ok' | 'empty' | 'error'
    - `learned` 'ok' | 'empty' | 'error'
    - `connections` 'ok' | 'empty' | 'error'
  - `setup` HomeSetupOut, required
    - `state` string, required
    - `badge_count` integer, required
    - `handoff_pending` boolean, required

## Other responses

- `422`: Validation Error

---

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