---
title: "Admin Onboarding Sessions"
method: GET
path: "/admin/onboarding-sessions"
---

# Admin Onboarding Sessions

`GET /admin/onboarding-sessions`

## Request

- Base URL: `https://api.local-mcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.local-mcp.com/admin/onboarding-sessions`
- Auth: none declared. Required headers: `x-admin-key`

Lista sesiones de onboarding con métricas de conversión + micro-funnel
por sesión (setup_opened, install_started, install_completed).

Adds to the previous shape:
  rows[*].ai_client / ai_client_version / os / country / city / isp
                     user_agent  (from the first cloud_connector_session event)
  rows[*].pre_token_claimed / pre_token_installed
                     (bool flags — pre_token micro-funnel per session)
  rows[*].setup_page_opened
                     (bool flag from events)
  rows[*].install_started_at / installed_at / install_version / install_os
                     (from pre_tokens row attributed to this session)
  funnel — now includes the full drop-off chain:
      total, discovered, setup_opened, install_started,
      install_completed, resolved, conversion_pct

New filters:
  ai_client — exact match on cloud_connector_session.ai_client
  os        — exact match on detected OS (macos/windows/linux/ios/android)
  country   — exact match on geo country code (e.g. "US", "AR")
  min_calls — rows with call_count >= this value
  exclude_tests (default true) — strip known test/probe clients
  hours — if set (>0), only sessions active in the last N hours
           (onboarding_sessions.updated_at; captures ongoing retries/activity)

## Query parameters

- `limit` integer
- `offset` integer
- `resolved` boolean
- `situation` string
- `ai_client` string
- `os` string
- `country` string
- `min_calls` integer
- `exclude_tests` boolean
- `hours` number, nullable: Only sessions whose onboarding_sessions.updated_at falls in the last N hours

## Headers

- `x-admin-key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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