---
title: "Get buyer cohorts by first purchase month and first channel"
method: GET
path: "/v1/events/ltv"
tags: ["Conversions"]
---

# Get buyer cohorts by first purchase month and first channel

`GET /v1/events/ltv`

## Request

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

Buyers grouped by the month of their first purchase and the platform that first brought them, with their purchases added up over the year after (months 0, 1, 3, 6 and 12).

A buyer is a hashed email, else external id, else phone. The first channel is the first touch's platform, else the first purchase's own campaign, else `none`. Values stay in each purchase's currency, one row per currency. Requires the Ads add-on.

## Query parameters

- `profileId` string
- `fromMonth` string, required
- `toMonth` string, required

## Response `200`

The cohorts, newest first.

- object
  - `fromMonth` string, required
  - `toMonth` string, required
  - `cohorts` object[], required
    - `cohort` string
    - `channel` string
    - `currency` string
    - `customers` integer
    - `revenue` object: Revenue from the cohort up to N months after its first purchase month, cumulative.
      - `m0` number
      - `m1` number
      - `m3` number
      - `m6` number
      - `m12` number

## 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/ltv/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)
