List call logs

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

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

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

	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/call-log")

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": [
    {
      "_id": "6703f1c2a9e4b0a1d2c3f4a5",
      "call_id": "call_abc123",
      "outcome": "answered",
      "direction": "outbound",
      "answered_by": "human",
      "duration": 184,
      "to": "+14155550123",
      "from": "+14155550987",
      "disposition": {
        "internal_id": 1,
        "external_id": "meeting_set",
        "external_name": "Meeting Set"
      },
      "contact": {
        "_id": "66f0a1b2c3d4e5f6a7b8c9d0",
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "title": "VP of Sales",
        "company": "Acme Corp",
        "phone_numbers": [
          {
            "type": "mobile",
            "number": "+14155550123"
          }
        ],
        "linkedin": "https://www.linkedin.com/in/johndoe",
        "timezone": "America/Los_Angeles",
        "source": "hubspot",
        "external_relations": {
          "sequence": {
            "id": "4821",
            "name": "Q3 Enterprise Outbound"
          }
        }
      },
      "contact_list": {
        "_id": "66e9b8a7c6d5e4f3a2b1c0d9",
        "name": "Q3 Enterprise Prospects"
      },
      "source": {
        "type": "hubspot",
        "id": null,
        "name": null
      },
      "user": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      },
      "phone_number": {
        "type": "mobile",
        "number": "+14155550123"
      },
      "recording_url": "https://recordings.example.com/call_abc123.mp3",
      "notes": "Booked a demo for Tuesday.",
      "summary": "John agreed to a 30-minute demo on Tuesday at 10am PT.",
      "is_completed": true,
      "started_at": "2026-09-30T17:02:11.000Z",
      "ended_at": "2026-09-30T17:05:15.000Z",
      "createdAt": "2026-09-30T17:05:20.000Z",
      "updatedAt": "2026-09-30T17:05:20.000Z"
    }
  ],
  "pagination": {
    "total": 150,
    "page": 1,
    "limit": 10,
    "pages": 15
  }
}

{
  "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"
}

Team and call logs

List call logs

Returns the team’s call history, newest first, with filters, sorting and pagination. Read-only.

page, limit and sort are top-level query parameters. Every filter goes under filters[...]; a filter sent without that prefix, such as search=Acme, is ignored and the unfiltered history comes back. Send list filters as filters[name][]=value, once per value; a single value can also be sent as filters[name]=value. A value that does not fit its filter, such as an unknown outcome or a date that does not parse, fails with 400.

Date filters compare against createdAt, the time the call was logged, and include both ends. With filters[search], results are ordered by relevance and sort is ignored. The pagination object is { total, page, limit, next } when no filter is sent and { total, page, limit, pages } when any filter is.

Calls from every team member are included, as are calls with is_completed: false, which analytics leave out. Use Get a call log for one call, List dispositions and List CRM sequences for filter values, and Get the current team for user IDs. Rate limit: the heavy-reads bucket, 120 requests per minute per team (see Rate limits).

GET

call-log

List call logs

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

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

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

	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/call-log")

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": [
    {
      "_id": "6703f1c2a9e4b0a1d2c3f4a5",
      "call_id": "call_abc123",
      "outcome": "answered",
      "direction": "outbound",
      "answered_by": "human",
      "duration": 184,
      "to": "+14155550123",
      "from": "+14155550987",
      "disposition": {
        "internal_id": 1,
        "external_id": "meeting_set",
        "external_name": "Meeting Set"
      },
      "contact": {
        "_id": "66f0a1b2c3d4e5f6a7b8c9d0",
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "title": "VP of Sales",
        "company": "Acme Corp",
        "phone_numbers": [
          {
            "type": "mobile",
            "number": "+14155550123"
          }
        ],
        "linkedin": "https://www.linkedin.com/in/johndoe",
        "timezone": "America/Los_Angeles",
        "source": "hubspot",
        "external_relations": {
          "sequence": {
            "id": "4821",
            "name": "Q3 Enterprise Outbound"
          }
        }
      },
      "contact_list": {
        "_id": "66e9b8a7c6d5e4f3a2b1c0d9",
        "name": "Q3 Enterprise Prospects"
      },
      "source": {
        "type": "hubspot",
        "id": null,
        "name": null
      },
      "user": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      },
      "phone_number": {
        "type": "mobile",
        "number": "+14155550123"
      },
      "recording_url": "https://recordings.example.com/call_abc123.mp3",
      "notes": "Booked a demo for Tuesday.",
      "summary": "John agreed to a 30-minute demo on Tuesday at 10am PT.",
      "is_completed": true,
      "started_at": "2026-09-30T17:02:11.000Z",
      "ended_at": "2026-09-30T17:05:15.000Z",
      "createdAt": "2026-09-30T17:05:20.000Z",
      "updatedAt": "2026-09-30T17:05:20.000Z"
    }
  ],
  "pagination": {
    "total": 150,
    "page": 1,
    "limit": 10,
    "pages": 15
  }
}

{
  "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"
}

How to send filters

page, limit and sort are top-level query parameters. Every filter is nested under filters[...]. A filter sent without the prefix, such as search=Acme, is ignored, and the unfiltered history comes back.

Kind	How to send it	Example
Single value	`filters[name]=value`	`filters[outcome]=answered`
List	`filters[name][]=value`, once per value. One value can also go without `[]`	`filters[user_ids][]=64d2b3f2c4e3a6b8f2d9e1a7`
Boolean	`true` or `false`	`filters[has_recording]=true`
Date	ISO 8601 timestamp	`filters[start_date]=2026-09-01T00:00:00.000Z`

curl reads square brackets in a URL as a range, so pass --globoff, or percent-encode them as %5B and %5D.

Examples

# Calls logged in September 2026 (UTC)
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[start_date]=2026-09-01T00:00:00.000Z&filters[end_date]=2026-09-30T23:59:59.999Z' \
  --header 'x-api-key: YOUR_API_KEY'

# One rep's answered calls of a minute or longer, longest first
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[user_ids][]=64d2b3f2c4e3a6b8f2d9e1a7&filters[outcome]=answered&filters[min_duration]=60&sort=-duration' \
  --header 'x-api-key: YOUR_API_KEY'

# Meetings set and referrals that have a recording
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[disposition_ids][]=1&filters[disposition_ids][]=4&filters[has_recording]=true' \
  --header 'x-api-key: YOUR_API_KEY'

# Every call to one CRM record
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[crm_ids][]=00Q5f000001abcXYZ' \
  --header 'x-api-key: YOUR_API_KEY'

# Calls in one CRM sequence
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[sequences][]=4821' \
  --header 'x-api-key: YOUR_API_KEY'

# Free-text search, 50 per page
curl --globoff 'https://client-api.salesfinity.co/v1/call-log?filters[search]=Acme&limit=50' \
  --header 'x-api-key: YOUR_API_KEY'

Gotchas

Dates are inclusive and filter on createdAt, the time the call was logged. A date with no time means midnight UTC, so filters[end_date]=2026-09-30 leaves out 30 September. Send 2026-09-30T23:59:59.999Z to include the whole day.
filters[exclude_negative_dispositions] is on whenever it is present, even as =false. Omit it to include every disposition, and do not combine it with filters[disposition_ids].
Search sets the order. With filters[search], results come back by relevance and sort is ignored.
pagination has two shapes. Without filters it is { total, page, next }. With any filter it is { total, page, limit, pages }. Both carry total and page, so you can always work out the page count as total / limit, rounded up.
Unfinished calls are included. An attempt the rep moved on from to dial another of the contact’s numbers, and an inbound call answered in the app that the rep has not logged yet, both have is_completed: false. Analytics leave these out; add filters[is_completed]=true to do the same.
Invalid IDs are dropped silently. In filters[user_ids][] and filters[contact_list_ids][], values that are not 24-character hex IDs are skipped. If none is valid, the filter is not applied and every call comes back.
connected and conversation differ from analytics. filters[status][] uses simpler rules than the metrics of the same names on Get analytics overview, so the counts will not match.
crm_id is filterable but not returned. filters[crm_ids][] matches the contact’s crm_id, which the contact object in the response leaves out.

Paging through everything

This list counts toward the heavy-reads rate limit of 120 requests per minute, so use the largest page size and stop on the last page:

// pairs, for example: [["filters[start_date]", "2026-09-01T00:00:00.000Z"], ["filters[user_ids][]", "64d2b3f2c4e3a6b8f2d9e1a7"]]
async function allCalls(pairs) {
  const calls = [];
  for (let page = 1; ; page++) {
    const params = new URLSearchParams([...pairs, ["page", String(page)], ["limit", "100"]]);
    const res = await fetch(`https://client-api.salesfinity.co/v1/call-log?${params}`, {
      headers: { "x-api-key": process.env.SALESFINITY_API_KEY },
    });
    if (!res.ok) throw new Error(`Salesfinity ${res.status}: ${await res.text()}`);
    const { data, pagination } = await res.json();
    calls.push(...data);
    if (data.length === 0 || page * 100 >= pagination.total) return calls;
  }
}

`contact_list` and `source`

Each call log includes both contact_list and source. contact_list is the dialing-queue list the call was placed from (its _id is the queue ID, the value filters[contact_list_ids][] matches). source identifies the original source list the call came from. For CSV lists, source.id is the CSV list ID, which differs from the queue ID. source.id and source.name are null for non-CSV lists. contact_list is unchanged and remains fully backward compatible.

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

limit

integer

default:10

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

Required range: 1 <= x <= 100

page

integer

default:1

Page number, 1-based.

Required range: x >= 1

sort

string

Comma-separated field names; prefix - for descending. Default: -createdAt. Ignored when filters[search] is set.

filters[start_date]

string<date-time>

Earliest createdAt to include, as an ISO 8601 timestamp. A date with no time means midnight UTC.

filters[end_date]

string<date-time>

Latest createdAt to include, as an ISO 8601 timestamp. A date with no time means midnight UTC, so 2026-09-30 stops at the start of that day; send 2026-09-30T23:59:59.999Z to include all of it.

filters[outcome]

enum<string>

Only calls that ended this way.

Available options:

answered,

no-answer,

cancelled

filters[direction]

enum<string>

Only outbound or only inbound calls.

Available options:

inbound,

outbound

filters[min_duration]

number

Shortest call to include, in seconds, inclusive.

Required range: x >= 0

filters[max_duration]

number

Longest call to include, in seconds, inclusive.

Required range: x >= 0

filters[has_recording]

boolean

true for calls with a recording_url, false for calls without one.

filters[answered_by]

enum<string>

Only calls answered by a person (human) or by voicemail or an answering machine (machine_start).

Available options:

human,

machine_start

filters[is_completed]

boolean

true leaves out calls that do not count as finished: attempts the rep moved on from to dial another of the contact's numbers, and inbound calls answered in the app that are not logged yet. false returns only those.

filters[disposition_ids]

integer[]

Disposition id values from List dispositions, matched against disposition.internal_id, so a default's custom variants are included. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[exclude_negative_dispositions]

boolean

Returns only calls with a positive disposition: IDs 1, 4, 6, 7 and 8 (Meeting Set, Referral, Call back later, Reach out in 6 months, Send an email). false, or leaving it out, includes every disposition. Do not combine it with filters[disposition_ids].

filters[user_ids]

string[]

Reps' user _id values from Get the current team. Send each value as its own filters[...][]= parameter; one value can also be sent without []. Values that are not 24-character hex IDs are dropped, and if none is valid the filter is not applied.

filters[contact_list_ids]

string[]

List IDs, matched against contact_list._id (the dialing-queue ID, which for CSV lists differs from source.id). Send each value as its own filters[...][]= parameter; one value can also be sent without []. Values that are not 24-character hex IDs are dropped, and if none is valid the filter is not applied.

filters[contact_ids]

string[]

Contact IDs, matched against contact._id. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[crm_ids]

string[]

CRM record IDs, matched against the contact's crm_id, which the response does not include. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[sequences]

string[]

Sequence id values from List CRM sequences, matched exactly against contact.external_relations.sequence.id. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[from]

string[]

Numbers the calls were placed from, matched exactly as stored in from. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[to]

string[]

Numbers called, matched exactly as stored in to. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

filters[search]

string

Case-insensitive search across the contact's name, company, account, title and email, the to/from and dialed numbers, and the call notes, summary and disposition, call purpose and call sentiment names. Call transcripts are not searched. Results are ordered by relevance.

filters[ids]

string[]

Call log _id values to fetch. Send each value as its own filters[...][]= parameter; one value can also be sent without []. A value that is not a valid ID fails with 400.

filters[status]

enum<string>[]

connected: answered, by a person or with no answering-machine result, with a disposition ID below 10. conversation: answered, by a person or with no answering-machine result, and lasting at least 60 seconds. Send both for either. These rules differ from the analytics metrics of the same names. Do not combine conversation with the duration filters. Send each value as its own filters[...][]= parameter; one value can also be sent without [].

Available options:

connected,

conversation

Response

One page of call logs, newest first unless sort or filters[search] says otherwise.

data

object[]

Show child attributes

pagination

object

Paging details. Without any filters[...] parameter the object is { total, page, next }; with one or more it is { total, page, limit, pages }.

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List call logs

How to send filters

Examples

Gotchas

Paging through everything

`contact_list` and `source`

Authorizations

Query Parameters

Response

​How to send filters

​Examples

​Gotchas

​Paging through everything

​contact_list and source

Authorizations

Query Parameters

Response

How to send filters

Examples

Gotchas

Paging through everything

`contact_list` and `source`