List the people behind an engagement metric

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "contact": {
        "_id": "6650d0a1b2c3d4e5f6a7b8c1",
        "first_name": "Dana",
        "last_name": "Reyes",
        "email": "[email protected]",
        "account": "Acme Logistics",
        "title": "VP of Operations"
      },
      "sequence_state": "6650e1a1b2c3d4e5f6a7b9d1",
      "state": "active",
      "current_step_order": 3,
      "event_count": 3,
      "last_at": "2026-10-02T15:12:09.000Z"
    }
  ],
  "pagination": {
    "total": 37,
    "page": 1,
    "limit": 25,
    "pages": 2
  },
  "metric": "opened",
  "people_count": 37,
  "event_count": 61
}

{
  "message": [
    "metric must be one of the following values: delivered, opened, clicked, replied, bounced, opted_out, failed, scheduled, contacted"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Sequences

List the people behind an engagement metric

Lists the people behind one engagement counter, one row per person, most recent activity first, 25 per page unless you set limit. metric is required.

Counters count events, so someone who opened three times is one row with event_count: 3. The top-level people_count and event_count give both totals, and pagination.total is people_count. This list reads the event history directly, so it can be ahead of the counters on GET /v2/sequencer/sequences/{id}/analytics, which are rebuilt every 15 minutes.

Each row links to the person’s enrollment in this sequence (sequence_state), the newest one if they were enrolled more than once. Counts toward the Sequencer reads rate limit.

GET

sequencer

sequences

{id}

analytics

people

List the people behind an engagement metric

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/analytics/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "contact": {
        "_id": "6650d0a1b2c3d4e5f6a7b8c1",
        "first_name": "Dana",
        "last_name": "Reyes",
        "email": "[email protected]",
        "account": "Acme Logistics",
        "title": "VP of Operations"
      },
      "sequence_state": "6650e1a1b2c3d4e5f6a7b9d1",
      "state": "active",
      "current_step_order": 3,
      "event_count": 3,
      "last_at": "2026-10-02T15:12:09.000Z"
    }
  ],
  "pagination": {
    "total": 37,
    "page": 1,
    "limit": 25,
    "pages": 2
  },
  "metric": "opened",
  "people_count": 37,
  "event_count": 61
}

{
  "message": [
    "metric must be one of the following values: delivered, opened, clicked, replied, bounced, opted_out, failed, scheduled, contacted"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Lists the people behind one engagement counter, one row per person, most recent activity first. 25 per page unless you set limit.

Example

Who opened, most recent first:

curl 'https://client-api.salesfinity.co/v2/sequencer/sequences/6650c1f2a9b8c7d6e5f40123/analytics/people?metric=opened' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "data": [
    {
      "contact": { "_id": "6650d0a1b2c3d4e5f6a7b8c1", "first_name": "Dana", "last_name": "Reyes", "email": "[email protected]", "account": "Acme Logistics", "title": "VP of Operations" },
      "sequence_state": "6650e1a1b2c3d4e5f6a7b9d1",
      "state": "active",
      "current_step_order": 3,
      "event_count": 3,
      "last_at": "2026-10-02T15:12:09.000Z"
    }
  ],
  "pagination": { "total": 37, "page": 1, "limit": 25, "pages": 2 },
  "metric": "opened",
  "people_count": 37,
  "event_count": 61
}

Metrics

`metric`	Counts
`delivered`, `opened`, `clicked`, `replied`, `bounced`, `opted_out`, `failed`	The matching email event
`scheduled`	Emails sent and tasks created
`contacted`	Emails sent or delivered, calls completed, tasks completed

Things to know

The counters on Get sequence analytics count events, so a person who opened three times is one row here with event_count: 3. people_count and event_count at the top give both totals, and pagination.total equals people_count.
This list reads the event history directly. The counters are rebuilt every 15 minutes, so for a short while the list can be ahead of the number on the counter.
sequence_state is the person’s enrollment in this sequence, the newest one if they were enrolled more than once. Open its timeline with List enrollment events.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

string

required

24-character sequence id.

Query Parameters

limit

number

Results per page. Default 25. Above 100 is treated as 100.

Required range: 1 <= x <= 100

page

number

default:1

Page number, 1-based, up to 10,000.

Required range: 1 <= x <= 10000

metric

enum<string>

required

Which counter to list the people behind. delivered, opened, clicked, replied, bounced, opted_out and failed each match one kind of event. scheduled is emails sent plus tasks created. contacted is emails sent or delivered, plus calls and tasks completed.

Available options:

delivered,

opened,

clicked,

replied,

bounced,

opted_out,

failed,

scheduled,

contacted

Response

A page of people.

A page of results.

data

object[]

required

Show child attributes

pagination

object

required

Pagination for the paged lists under /v2/sequencer. Every paged list uses this one shape; a few short lists (a sequence's steps, the team's policies, a task's events and enrollment runs) return a plain array instead.

Show child attributes

metric

string

The metric listed.

people_count

integer

Distinct people with at least one matching event. Same as pagination.total.

event_count

integer

Total matching events across those people.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List the people behind an engagement metric

Example

Metrics

Things to know

Authorizations

Path Parameters

Query Parameters

Response

​Example

​Metrics

​Things to know

Authorizations

Path Parameters

Query Parameters

Response

Example

Metrics

Things to know