---
title: "Sign-ups, activations and paid accounts by first-touch campaign"
method: GET
path: "/v1/admin/attribution/stats"
tags: ["billing"]
---

# Sign-ups, activations and paid accounts by first-touch campaign

`GET /v1/admin/attribution/stats`

## Request

- Base URL: `https://api.hyperresearch.ai`
- URL: `https://api.hyperresearch.ai/v1/admin/attribution/stats`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `hr_session`

Operator read. Accounts created since `from` (default: 30 days ago), grouped by first-touch utm_source, utm_campaign and utm_content, with how many started a run and how many paid. Operator and deleted accounts are excluded; unattributed sign-ups are the row of nulls. No email or account id is returned.

## Query parameters

- `from` string

## Response `200`

Attribution funnel

- AttributionStats
  - `from` string, required
  - `rows` object[], required
    - `utm_source` string, nullable, required
    - `utm_campaign` string, nullable, required
    - `utm_content` string, nullable, required
    - `sign_ups` integer, required
    - `with_gclid` integer, required
    - `with_braid_only` integer, required
    - `activated` integer, required
    - `paid` integer, required
    - `paid_value_cents` integer, required

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Insufficient scope or plan
- `404`: Not found
- `429`: Rate limited or over quota
- `500`: Internal error

---

[API](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api.md) · [All operations](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/revisions/726ef831ebf4?raw)