---
title: "List the touch paths that lead to conversions"
method: GET
path: "/v1/events/paths"
tags: ["Conversions"]
---

# List the touch paths that lead to conversions

`GET /v1/events/paths`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/events/paths`
- Auth: HTTP bearer

The most frequent sequences of touches people made before a conversion (sale, lead or another counted event) whose time falls in the range: ad clicks, tagged visits, search, referrals and earlier lead forms, oldest first.

Only conversions with more than one touch have a path. Without `profileId` it covers every profile you can access. Requires the Ads add-on.

## Query parameters

- `profileId` string
- `fromDate` string, date, required
- `toDate` string, date, required
- `limit` integer

## Response `200`

The paths, most frequent first.

- object
  - `fromDate` string, date, required
  - `toDate` string, date, required
  - `paths` object[], required
    - `steps` string[]: Each touch as its kind, or `kind:platform` when it named a campaign.
    - `conversions` integer
    - `sales` integer: How many were purchases.
    - `revenue` number: The value of the purchases, as sent.
    - `avgDays` number: Average days from the first touch to the conversion.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.

## Changes

- **2026-11-18** `0eb093be6480`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/events/paths/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/988c032ae545?raw)
