---
title: "Desktop app and LinkedIn account state"
method: GET
path: "/api/v1/status"
tags: ["Status"]
---

# Desktop app and LinkedIn account state

`GET /api/v1/status`

## Request

- Base URL: `https://www.zen-mode.io`
- URL: `https://www.zen-mode.io/api/v1/status`
- Auth: HTTP bearer

Whether the desktop app is up, and per-account pacing counters. The desktop reports about once an hour, so `desktop_active` is true when it last reported within 75 minutes; `desktop_state` separates a desktop that went quiet from one never seen. Active means the app was open at `last_seen`, not that a campaign is running: read `accounts[].is_running` for that. A desktop that closed a minute after reporting still reads active for up to 75 minutes.

## Response `200`

Current state. When `desktop_state` is `went_quiet` or `never_seen`, `accounts` is `[]` and `phase`/`linkedin_status` are absent; `last_seen` is null only for `never_seen`.

- object
  - `desktop_active` boolean
  - `desktop_state` 'active' | 'went_quiet' | 'never_seen'
  - `last_seen` string, date-time, nullable
  - `phase` 'idle' | 'starting' | 'scraping' | 'connecting' | 'checking_replies' | 'monitoring' | 'error', nullable
  - `linkedin_status` string, nullable
  - `active_campaign_count` integer
  - `connections_sent_today` integer
  - `accounts` object[]
    - `display_name` string
    - `is_running` boolean
    - `phase` string, nullable
    - `campaign_id` integer, nullable
    - `daily_actions` integer
    - `daily_limit` integer
    - `weekly_actions` integer
    - `weekly_limit` integer
    - `linkedin_status` string, nullable
    - `started_at` string, date-time, nullable
    - `last_action_at` string, date-time, nullable

## Other responses

- `401`: Missing, malformed or invalid Authorization header, or an unknown API key.
- `403`: The key is valid but the account's plan does not include API access.
- `429`: Rate limit exceeded (100 requests/minute). Carries `Retry-After`.
- `500`: Unhandled server error.

---

[API](https://skmtc.dev/zen-mode/apis/zenmode-api.md) · [All operations](https://skmtc.dev/zen-mode/apis/zenmode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zen-mode/apis/zenmode-api/revisions/2769372f1e3f?raw)
