List call performance by contact list

curl --request GET \
  --url https://client-api.salesfinity.co/v1/analytics/list-performance \
  --header 'x-api-key: <api-key>'

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

fetch('https://client-api.salesfinity.co/v1/analytics/list-performance', 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/v1/analytics/list-performance",
  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/v1/analytics/list-performance"

	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/v1/analytics/list-performance")

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

{
  "totalCount": 2,
  "data": [
    {
      "_id": "66e9b8a7c6d5e4f3a2b1c0d9",
      "name": "Q3 Enterprise Prospects",
      "source": "csv",
      "total_calls": 640,
      "connected_calls": 168,
      "conversations": 52,
      "meetings_set": 9,
      "good_quality_contacts": 512,
      "data_quality": 0.8,
      "owner": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      }
    },
    {
      "_id": null,
      "name": "Unknown",
      "source": "Unknown",
      "total_calls": 41,
      "connected_calls": 6,
      "conversations": 2,
      "meetings_set": 0,
      "good_quality_contacts": 30,
      "data_quality": 0.73,
      "owner": {}
    }
  ],
  "page": 1,
  "limit": 10,
  "next": null,
  "prev": null
}

{
  "message": [
    "start_date must be a Date instance"
  ],
  "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": "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"
}

Analytics

List call performance by contact list

Returns call metrics per contact list for a period, most-called list first, with pagination. Read-only.

Calls counted are completed calls (is_completed is not false) logged between start_date and end_date by the team’s active members, or by the users in user_ids. Periods are whole UTC days. Results are cached for up to 5 minutes, so repeating a request can return the same numbers. Calls placed outside a list are grouped in one row with _id: null and name: "Unknown". Metrics follow the definitions in Get analytics overview.

Paginate with page and limit; next and prev give the adjacent page numbers. Rate limit: the heavy-reads bucket, 120 requests per minute per team (see Rate limits).

GET

analytics

list-performance

List call performance by contact list

curl --request GET \
  --url https://client-api.salesfinity.co/v1/analytics/list-performance \
  --header 'x-api-key: <api-key>'

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

fetch('https://client-api.salesfinity.co/v1/analytics/list-performance', 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/v1/analytics/list-performance",
  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/v1/analytics/list-performance"

	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/v1/analytics/list-performance")

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

{
  "totalCount": 2,
  "data": [
    {
      "_id": "66e9b8a7c6d5e4f3a2b1c0d9",
      "name": "Q3 Enterprise Prospects",
      "source": "csv",
      "total_calls": 640,
      "connected_calls": 168,
      "conversations": 52,
      "meetings_set": 9,
      "good_quality_contacts": 512,
      "data_quality": 0.8,
      "owner": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      }
    },
    {
      "_id": null,
      "name": "Unknown",
      "source": "Unknown",
      "total_calls": 41,
      "connected_calls": 6,
      "conversations": 2,
      "meetings_set": 0,
      "good_quality_contacts": 30,
      "data_quality": 0.73,
      "owner": {}
    }
  ],
  "page": 1,
  "limit": 10,
  "next": null,
  "prev": null
}

{
  "message": [
    "start_date must be a Date instance"
  ],
  "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": "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"
}

curl 'https://client-api.salesfinity.co/v1/analytics/list-performance?start_date=2026-09-01&end_date=2026-09-30&limit=25' \
  --header 'x-api-key: YOUR_API_KEY'

Calls, dates and users are counted exactly as in Get analytics overview: finished calls only, active members by default, whole UTC days. connected_calls, conversations and meetings_set use the definitions on that page.

Rows

There is one row per dialing-queue list. Its _id is the value call logs carry in contact_list._id, and the value filters[contact_list_ids][] takes on List call logs.
Calls placed outside any list are grouped in one row with _id: null, name: "Unknown" and an empty owner.
Rows are always sorted by total_calls, highest first. There is no sort parameter.
search matches the list name, case-insensitively, and is read as a regular expression. Escape ., (, + and similar characters to match them literally.

Data quality

Field	Definition
`good_quality_contacts`	Calls to a `mobile` or `direct` number that were not dispositioned Bad Number (13) or Wrong Contact (5). It counts calls, not contacts.
`data_quality`	`good_quality_contacts / total_calls`, a ratio from 0 to 1, two decimals

A low data_quality means many calls went to office lines, or to numbers that turned out wrong.

Paging

The response carries totalCount, page, limit, and next and prev, which are page numbers or null. Keep requesting page=next until next is null.

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.

Query Parameters

start_date

string<date>

First day of the period, as YYYY-MM-DD. The period starts at 00:00:00 UTC on this date. A full timestamp is accepted, but it is converted to UTC and only the date is kept. Defaults to 7 days before end_date.

end_date

string<date>

Last day of the period, as YYYY-MM-DD, included through 23:59:59.999 UTC. A full timestamp is accepted, but it is converted to UTC and only the date is kept, so 2026-09-30T23:00:00-05:00 ends the period on 1 October. Defaults to today (UTC).

user_ids

string[]

Reps to include, by user _id from Get the current team. Repeat the parameter (user_ids=...&user_ids=...) or send one comma-separated value. Each must be a valid user ID; one that is not fails with 400. Defaults to the team's active members; pass IDs to include inactive ones.

disposition_ids

integer[]

Count only calls with these disposition IDs from List dispositions. Repeat the parameter or send one comma-separated value, for example disposition_ids=1,4.

timezone

string

Accepted but not applied: periods are always whole UTC days.

page

integer

default:1

Page number, 1-based.

Required range: x >= 1

limit

integer

default:10

Rows per page. Default 10. Above 100 is treated as 100.

Required range: 1 <= x <= 100

string

Case-insensitive match on the list name. The value is read as a regular expression, so escape characters such as ., ( and + to match them literally.

Response

One page of lists, sorted by total_calls, highest first.

totalCount

integer

required

Rows across all pages.

data

object[]

required

This page's lists, sorted by total_calls, highest first.

Show child attributes

page

integer

required

Current page.

limit

integer

required

Page size.

integer | null

Next page number, or null on the last page.

integer | null

Previous page number, or null on the first page.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List call performance by contact list

Rows

Data quality

Paging

Authorizations

Query Parameters

Response

​Rows

​Data quality

​Paging

Authorizations

Query Parameters

Response

Rows

Data quality

Paging