---
title: "Connect funnel and connection outcomes"
method: GET
path: "/analytics/connect"
tags: ["Analytics"]
---

# Connect funnel and connection outcomes

`GET /analytics/connect`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/analytics/connect`
- Auth: HTTP bearer

The widget funnel (sessions, how many entered a domain, were offered a one-click or sign-in rail, were shown records to copy, succeeded, where the rest stopped, per provider and root versus subdomain) and connection outcomes (live rate, time to live, per provider and method, why the rest are stuck), plus a daily series. API key; any member role.

## Query parameters

- `days` integer
- `app_id` string

## Response `200`

Analytics

- ConnectAnalytics
  - `window` object, required
    - `from` string, date-time
    - `to` string, date-time
    - `days` integer
    - `application_id` string
  - `widget` object, required
    - `sessions` integer
    - `entered_domain` integer
    - `analyzed` integer
    - `offered_automatic` integer
    - `shown_manual` integer
    - `succeeded` integer
    - `succeeded_automatic` integer
    - `errored` integer
    - `conversion_rate` number
    - `median_seconds_to_success` integer
    - `drop_off` AnalyticsCount[]
      - `key` string
      - `count` integer
    - `errors` AnalyticsCount[]
      - `key` string
      - `count` integer
    - `providers` object[]
      - `provider` string
      - `sessions` integer
      - `succeeded` integer
      - `automatic` integer
    - `domain_kinds` object[]
      - `kind` string
      - `sessions` integer
      - `succeeded` integer
  - `connections` object, required
    - `total` integer
    - `live` integer
    - `pending` integer
    - `propagating` integer
    - `failed` integer
    - `live_rate` number
    - `median_seconds_to_live` integer
    - `by_provider` object[]
      - `provider` string
      - `total` integer
      - `live` integer
      - `pending` integer
      - `failed` integer
    - `by_method` AnalyticsGroup[]
      - `key` string
      - `total` integer
      - `live` integer
    - `by_kind` AnalyticsGroup[]
      - `key` string
      - `total` integer
      - `live` integer
    - `stuck` AnalyticsCount[]
      - `key` string
      - `count` integer
  - `daily` object[], required
    - `date` string
    - `sessions` integer
    - `succeeded` integer
    - `created` integer
    - `went_live` integer
  - `truncated` boolean, required

## Other responses

- `400`: Error envelope: {code, title, details}.
- `401`: Error envelope: {code, title, details}.
- `404`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)