> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# talkvalue path analysis event trend

> Net new vs returning registrants per event, plus latest-event headline metrics and deltas.

Compute the registration-trend snapshot the dashboard plots on the [Registration trend](/path/analytics/registration-trend) card. Each event in the result carries its total registrants split into net-new and returning, with the corresponding rates and a summary block that highlights the latest event and how it moved against the prior data point.

## Synopsis

```bash theme={null}
talkvalue path analysis event trend [options]
```

## Options

| Flag            | Type    | Description                                                                         |
| --------------- | ------- | ----------------------------------------------------------------------------------- |
| `--tag-id <id>` | integer | Limit to events that carry the given tag. Defaults to every event in the workspace. |

## Examples

### 1. Trend across every event

```bash theme={null}
talkvalue path analysis event trend --json | jq '.data.summary'
```

Returns the summary block: unique audience size, latest event's headline numbers, and the deltas against the prior event.

### 2. Per-event net-new rate report

```bash theme={null}
talkvalue path analysis event trend --json \
  | jq -r '.data.events[] | [.name, .total, .netNew, .netNewRate] | @csv' \
  > reports/event-trend.csv
```

Writes a four-column CSV for every event. Handy to drop into a spreadsheet for a longer-form chart than the dashboard card shows.

### 3. Tag-scoped trend

```bash theme={null}
talkvalue path analysis event trend --tag-id 4 --json | jq '.data.events | length'
```

Counts how many tagged events (for example, every webinar) made it into the trend, so you can sanity-check the slice before charting it.

## Response

```jsonc theme={null}
{
  "data": {
    "events": [
      {
        "id": 18,
        "name": "Spring Summit",
        "startAt": "2026-03-12T17:00:00Z",
        "total": 412,
        "netNew": 87,
        "returning": 325,
        "netNewRate": 0.2112,
        "returningRate": 0.7888
      }
    ],
    "summary": {
      "uniqueAudience": 2589,
      "latestTotal": 412,
      "latestNetNewRate": 0.2112,
      "returnRate": 0.7888,
      "latestName": "Spring Summit",
      "totalDelta":        { /* delta vs prior event */ },
      "netNewRateDelta":   { /* delta vs prior event */ },
      "returnRateDelta":   { /* delta vs prior event */ }
    }
  }
}
```

`netNewRate + returningRate ≈ 1.0` for each event. The `*Delta` blocks under `summary` are `null` when there is no prior event to compare against.

## See also

* [`analysis channel attribution`](/cli/commands/path/analysis/channel-attribution). Drill from a trending event into the channels that drove its acquisition.
* [`event list`](/cli/commands/path/event/list). Pair event IDs with trend numbers.
* [Registration trend](/path/analytics/registration-trend). The dashboard surface this command mirrors.
* [Recipe: New registrants this week](/cli/recipes/new-registrants). Narrower script that feeds off the same event data.