---
title: "Get your home"
description: "What the app's home shows, decided for you now: unread notifications and access requests waiting on you (attention), the open to-dos that @mention you in…"
canonical_url: https://docs.markdrop.in/api/home/get-your-home
last_updated: 2026-11-05
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Get your home

`GET https://api.markdrop.in/api/v1/home`

What the app's home shows, decided for you now: unread notifications and access requests waiting on you (`attention`), the open to-dos that @mention you in pages you can read (`actions`, with `can_tick` when you may edit the page), the latest meetings across your workspaces (`meetings`), your workspaces with people, item and meeting counts (`workspaces`), and whether Google Meet is connected (`meet`). No AI is used.

- **Authentication:** API token required: `Authorization: Bearer mdk_…`.
- **Rate limit:** 120 per minute per IP address.
- **Guide:** [Your home](https://docs.markdrop.in/get-started/tour#your-home)

## Responses

- `200`: OK.
- `401`: No token, or the token is revoked or mistyped.
- `429`: Too many requests from your IP address. Wait the seconds in `Retry-After`.

## Examples

**curl**

```bash
curl https://api.markdrop.in/api/v1/home \
  -H "Authorization: Bearer $MARKDROP_TOKEN"
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/home", {
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

r = requests.get(
    "https://api.markdrop.in/api/v1/home",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
)
r.raise_for_status()
print(r.json())
```