---
title: "Get the organization acquisition and activation funnel"
method: GET
path: "/analytics/overview"
---

# Get the organization acquisition and activation funnel

`GET /analytics/overview`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/analytics/overview`
- Auth: HTTP bearer

Returns aggregates only and requires organization owner access.

## Query parameters

- `days` integer
- `at` string, date-time

## Response `200`

Organization acquisition overview

- AcquisitionOverviewEnvelope
  - `data` object, required
    - `days` integer, required
    - `generatedAt` string, date-time, required
    - `scope` 'platform' | 'organization', required
    - `funnel` AcquisitionFunnel, required
      - `visitors` integer, required
      - `engagedVisitors` integer, required
      - `ctaVisitors` integer, required
      - `signedInVisitors` integer, required
      - `activatedPrincipals` integer, required
      - `firstHandoversCreated` integer, required
      - `continuedHandovers` integer, required
      - `continuedOriginators` integer, required
      - `totalHandoversCreated` integer, required
      - `totalCreatorPrincipals` integer, required
    - `previous` AcquisitionPreviousPeriod, required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `funnel` AcquisitionFunnel, required
        - `visitors` integer, required
        - `engagedVisitors` integer, required
        - `ctaVisitors` integer, required
        - `signedInVisitors` integer, required
        - `activatedPrincipals` integer, required
        - `firstHandoversCreated` integer, required
        - `continuedHandovers` integer, required
        - `continuedOriginators` integer, required
        - `totalHandoversCreated` integer, required
        - `totalCreatorPrincipals` integer, required
    - `funnelDelta` AcquisitionFunnel, required
      - `visitors` integer, required
      - `engagedVisitors` integer, required
      - `ctaVisitors` integer, required
      - `signedInVisitors` integer, required
      - `activatedPrincipals` integer, required
      - `firstHandoversCreated` integer, required
      - `continuedHandovers` integer, required
      - `continuedOriginators` integer, required
      - `totalHandoversCreated` integer, required
      - `totalCreatorPrincipals` integer, required
    - `channels` object[], required
      - `source` string, required
      - `medium` string, required
      - `campaign` string, required
      - `visitors` integer, required
    - `pages` object[], required
      - `path` string, required
      - `pageKind` string, required
      - `visitors` integer, required
      - `views` integer, required

## Other responses

- `400`: Request error
- `403`: Request error

---

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