---
title: "Internal per-ref funnel rollup"
method: GET
path: "/v1/funnel/refs"
---

# Internal per-ref funnel rollup

`GET /v1/funnel/refs`

## Request

- Base URL: `https://api.lodestarstamp.com`
- URL: `https://api.lodestarstamp.com/v1/funnel/refs`
- Auth: one of:
  - none
  - API key in header `X-Lodestar-Key`
  - OAuth 2 (authorization code, authorization URL `https://api.lodestarstamp.com/oauth/authorize`, token URL `https://api.lodestarstamp.com/oauth/token`, scopes: `mcp:read`)
  - API key in header `PAYMENT-SIGNATURE`

Desk rollup of ref codes. Requires Worker secret INTERNAL_OPS_KEY as Authorization: Bearer. 401 if the bearer is missing or wrong. 503 if the secret is not bound. X-Lodestar-Consumer does not grant this route. Returns first_seen, last_seen, pageviews, paths, and booleans for claim_click, subscribe, and checkout. Analytics Engine stays instrumented_not_queryable.

## Query parameters

- `since` string

## Headers

- `Authorization` string, required

## Response `200`

Per-ref rollup

## Other responses

- `400`: Bad since
- `401`: Missing or wrong bearer
- `503`: INTERNAL_OPS_KEY or CONSUMERS unbound

---

[API](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api.md) · [All operations](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/revisions/af78368ab7a5?raw)