List scored calls

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

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

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

	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/scored-calls")

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": "6704a9b8c7d6e5f4a3b2c1d0",
      "insight": {
        "total_score": 71,
        "lead": {
          "function": "Sales",
          "tech_stack_mentioned": [
            "Salesforce",
            "Outreach"
          ],
          "current_vendor": "Competitor Inc",
          "vendor_contract_end": null,
          "budget_owner": true,
          "has_budget": null,
          "priority_level": "medium",
          "timeline_to_buy": "3-6mo",
          "fit_score": 80,
          "is_decision_maker": true,
          "is_correct_persona": true,
          "pain_point_resonated": true,
          "is_qualified_meeting": true,
          "is_likely_to_buy": false,
          "prospect_lifecycle_stage": [
            "solution_aware"
          ]
        },
        "messaging": {
          "value_prop_resonated": [
            "efficiency",
            "time_savings"
          ],
          "objection_outcome": [
            "handled"
          ],
          "emotional_triggers": [
            "frustration_with_current_tool"
          ],
          "recommendation_to_nail_messaging": "Lead with the connect-rate gain for teams their size."
        },
        "targeting_feedback": {
          "persona_fit": "excellent",
          "industry_fit": "good",
          "persona_seniority": "vp",
          "title_relevance": "good",
          "data_quality_issue": [],
          "future_follow_up_needed": true,
          "follow_up_reason": [
            "renewal"
          ]
        },
        "metadata": {
          "duration_sec": 184,
          "asr_confidence_avg": 0.85,
          "audio_features_available": false,
          "talk_listen_ratio_rep": 0.48,
          "total_questions": 8,
          "open_question_ratio": 0.63,
          "interruptions_by_rep": 1,
          "core_pitch_duration_sec": 22,
          "estimated_wpm_rep": 158,
          "estimated_wpm_prospect": 142,
          "objections_detected": [
            "incumbent_solution"
          ]
        },
        "facets": {
          "intro": {
            "score": 4,
            "weight_pct": 10,
            "explanation": "Asked permission and gave a reason for the call within ten seconds.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 2.1,
                "end_sec": 9.4,
                "text": "Hi John, it's Jane from Salesfinity. Mind if I take 30 seconds to say why I called?",
                "objection": null
              }
            ],
            "checks": {
              "permission_opener_used": true,
              "opener_length_sec": 7,
              "time_to_opener_sec": 2,
              "improvement_recommendation": "Name a peer company in the opener."
            }
          },
          "discovery": {
            "score": 3.5,
            "weight_pct": 25,
            "explanation": "Good open questions on current tools; timing never came up.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 31,
                "end_sec": 36.2,
                "text": "How are your reps building call lists today?",
                "objection": null
              }
            ],
            "metrics": {
              "total_questions": 8,
              "open_question_ratio": 0.63,
              "improvement_recommendation": "Ask when they plan to change tools.",
              "topic_coverage": [
                "pain",
                "current_tools"
              ]
            }
          },
          "pitch": {
            "score": 3.5,
            "weight_pct": 20,
            "explanation": "Tied the pitch to the list-building pain they described.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 58.3,
                "end_sec": 74,
                "text": "Teams like yours usually triple live conversations per hour.",
                "objection": null
              }
            ],
            "metrics": {
              "core_pitch_duration_sec": 22,
              "tailored_to_discovery": true,
              "improvement_recommendation": "Add one customer result.",
              "outcome_keywords": [
                "more_meetings",
                "save_time"
              ]
            }
          },
          "tonality": {
            "score": 4,
            "weight_pct": 15,
            "explanation": "Calm and conversational, with some filler words.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 80.5,
                "end_sec": 86,
                "text": "Totally fair, and that's why I wanted to ask.",
                "objection": null
              }
            ],
            "metrics": {
              "estimated_wpm": 158,
              "interruptions_by_rep": 1,
              "filler_density_per_min": 2.1,
              "improvement_recommendation": "Pause instead of saying 'um'."
            }
          },
          "objection_handling": {
            "score": 3,
            "weight_pct": 15,
            "explanation": "Acknowledged the incumbent but did not probe why they chose it.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 95.2,
                "end_sec": 99.8,
                "text": "We already use another dialer.",
                "objection": "incumbent_solution"
              }
            ],
            "metrics": {
              "objections_detected": [
                "incumbent_solution"
              ],
              "followup_probe_present": false,
              "resolution_check_present": true,
              "improvement_recommendation": "Ask what they would change about their current dialer."
            }
          },
          "cta": {
            "score": 3.5,
            "weight_pct": 15,
            "explanation": "Asked for a meeting and offered two times.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 150,
                "end_sec": 158.4,
                "text": "Would Tuesday at 10 or Wednesday at 2 work for a quick demo?",
                "objection": null
              }
            ],
            "metrics": {
              "cta_attempted": true,
              "cta_type": "meeting",
              "specific_time_offered": true,
              "improvement_recommendation": "Recap the agreed time before hanging up.",
              "outcome": "accepted"
            }
          }
        },
        "gaps": {
          "skill": 0.6,
          "playbook": 0.3,
          "rationale": "Discovery gaps look like habit rather than script."
        },
        "coaching": {
          "top_wins": [
            "Permission-based opener",
            "Pitch tied to discovery"
          ],
          "top_opportunities": [
            "Ask about timing",
            "Probe objections"
          ],
          "suggested_drills": [
            {
              "facet": "discovery",
              "assignment": "Run five practice calls that each cover timeline and decision process."
            }
          ]
        }
      },
      "call_log": {
        "_id": "6703f1c2a9e4b0a1d2c3f4a5",
        "contact": {
          "first_name": "John",
          "last_name": "Doe",
          "company": "Acme Corp",
          "title": "VP of Sales"
        },
        "recording_url": "https://recordings.example.com/call_abc123.mp3",
        "duration": 184
      },
      "user": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      },
      "type": "call",
      "createdAt": "2026-09-30T17:08:02.000Z",
      "updatedAt": "2026-09-30T17:08:02.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "limit": 10,
    "pages": 5
  }
}

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

Scored calls

List scored calls

Returns the team’s AI-scored calls, newest first, each with its scorecard. Read-only.

A call is scored when the team has call scoring on, the call has a transcript, it lasted at least the team’s minimum length (60 seconds by default), and, unless the team turned the check off, a person answered. Team owners and admins set these rules and the rubric under Settings → Coaching → Call scoring. Rescoring a call replaces its scorecard on the same record.

Each of the six facets is scored 0 to 5 and weighted by the team’s rubric (default weights: intro 10, discovery 25, pitch 20, tonality 15, objection handling 15, CTA 15). total_score is the weighted average scaled to 0 to 100. A team can add up to six custom facets: they count toward total_score but are not returned, so the six weights shown can add up to less than 100.

start_date and end_date bound createdAt, and min_score and max_score bound insight.total_score; both ends are included. There is no filter by call log; match call_log._id in the results. Rate limit: the heavy-reads bucket, 120 requests per minute per team (see Rate limits).

GET

scored-calls

List scored calls

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

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

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

	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/scored-calls")

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": "6704a9b8c7d6e5f4a3b2c1d0",
      "insight": {
        "total_score": 71,
        "lead": {
          "function": "Sales",
          "tech_stack_mentioned": [
            "Salesforce",
            "Outreach"
          ],
          "current_vendor": "Competitor Inc",
          "vendor_contract_end": null,
          "budget_owner": true,
          "has_budget": null,
          "priority_level": "medium",
          "timeline_to_buy": "3-6mo",
          "fit_score": 80,
          "is_decision_maker": true,
          "is_correct_persona": true,
          "pain_point_resonated": true,
          "is_qualified_meeting": true,
          "is_likely_to_buy": false,
          "prospect_lifecycle_stage": [
            "solution_aware"
          ]
        },
        "messaging": {
          "value_prop_resonated": [
            "efficiency",
            "time_savings"
          ],
          "objection_outcome": [
            "handled"
          ],
          "emotional_triggers": [
            "frustration_with_current_tool"
          ],
          "recommendation_to_nail_messaging": "Lead with the connect-rate gain for teams their size."
        },
        "targeting_feedback": {
          "persona_fit": "excellent",
          "industry_fit": "good",
          "persona_seniority": "vp",
          "title_relevance": "good",
          "data_quality_issue": [],
          "future_follow_up_needed": true,
          "follow_up_reason": [
            "renewal"
          ]
        },
        "metadata": {
          "duration_sec": 184,
          "asr_confidence_avg": 0.85,
          "audio_features_available": false,
          "talk_listen_ratio_rep": 0.48,
          "total_questions": 8,
          "open_question_ratio": 0.63,
          "interruptions_by_rep": 1,
          "core_pitch_duration_sec": 22,
          "estimated_wpm_rep": 158,
          "estimated_wpm_prospect": 142,
          "objections_detected": [
            "incumbent_solution"
          ]
        },
        "facets": {
          "intro": {
            "score": 4,
            "weight_pct": 10,
            "explanation": "Asked permission and gave a reason for the call within ten seconds.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 2.1,
                "end_sec": 9.4,
                "text": "Hi John, it's Jane from Salesfinity. Mind if I take 30 seconds to say why I called?",
                "objection": null
              }
            ],
            "checks": {
              "permission_opener_used": true,
              "opener_length_sec": 7,
              "time_to_opener_sec": 2,
              "improvement_recommendation": "Name a peer company in the opener."
            }
          },
          "discovery": {
            "score": 3.5,
            "weight_pct": 25,
            "explanation": "Good open questions on current tools; timing never came up.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 31,
                "end_sec": 36.2,
                "text": "How are your reps building call lists today?",
                "objection": null
              }
            ],
            "metrics": {
              "total_questions": 8,
              "open_question_ratio": 0.63,
              "improvement_recommendation": "Ask when they plan to change tools.",
              "topic_coverage": [
                "pain",
                "current_tools"
              ]
            }
          },
          "pitch": {
            "score": 3.5,
            "weight_pct": 20,
            "explanation": "Tied the pitch to the list-building pain they described.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 58.3,
                "end_sec": 74,
                "text": "Teams like yours usually triple live conversations per hour.",
                "objection": null
              }
            ],
            "metrics": {
              "core_pitch_duration_sec": 22,
              "tailored_to_discovery": true,
              "improvement_recommendation": "Add one customer result.",
              "outcome_keywords": [
                "more_meetings",
                "save_time"
              ]
            }
          },
          "tonality": {
            "score": 4,
            "weight_pct": 15,
            "explanation": "Calm and conversational, with some filler words.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 80.5,
                "end_sec": 86,
                "text": "Totally fair, and that's why I wanted to ask.",
                "objection": null
              }
            ],
            "metrics": {
              "estimated_wpm": 158,
              "interruptions_by_rep": 1,
              "filler_density_per_min": 2.1,
              "improvement_recommendation": "Pause instead of saying 'um'."
            }
          },
          "objection_handling": {
            "score": 3,
            "weight_pct": 15,
            "explanation": "Acknowledged the incumbent but did not probe why they chose it.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 95.2,
                "end_sec": 99.8,
                "text": "We already use another dialer.",
                "objection": "incumbent_solution"
              }
            ],
            "metrics": {
              "objections_detected": [
                "incumbent_solution"
              ],
              "followup_probe_present": false,
              "resolution_check_present": true,
              "improvement_recommendation": "Ask what they would change about their current dialer."
            }
          },
          "cta": {
            "score": 3.5,
            "weight_pct": 15,
            "explanation": "Asked for a meeting and offered two times.",
            "insufficient_evidence": false,
            "evidence": [
              {
                "start_sec": 150,
                "end_sec": 158.4,
                "text": "Would Tuesday at 10 or Wednesday at 2 work for a quick demo?",
                "objection": null
              }
            ],
            "metrics": {
              "cta_attempted": true,
              "cta_type": "meeting",
              "specific_time_offered": true,
              "improvement_recommendation": "Recap the agreed time before hanging up.",
              "outcome": "accepted"
            }
          }
        },
        "gaps": {
          "skill": 0.6,
          "playbook": 0.3,
          "rationale": "Discovery gaps look like habit rather than script."
        },
        "coaching": {
          "top_wins": [
            "Permission-based opener",
            "Pitch tied to discovery"
          ],
          "top_opportunities": [
            "Ask about timing",
            "Probe objections"
          ],
          "suggested_drills": [
            {
              "facet": "discovery",
              "assignment": "Run five practice calls that each cover timeline and decision process."
            }
          ]
        }
      },
      "call_log": {
        "_id": "6703f1c2a9e4b0a1d2c3f4a5",
        "contact": {
          "first_name": "John",
          "last_name": "Doe",
          "company": "Acme Corp",
          "title": "VP of Sales"
        },
        "recording_url": "https://recordings.example.com/call_abc123.mp3",
        "duration": 184
      },
      "user": {
        "_id": "64d2b3f2c4e3a6b8f2d9e1a7",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "[email protected]"
      },
      "type": "call",
      "createdAt": "2026-09-30T17:08:02.000Z",
      "updatedAt": "2026-09-30T17:08:02.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "limit": 10,
    "pages": 5
  }
}

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

Which calls are scored

A call gets a scorecard when all of these are true:

Call scoring is on for the team.
The call has a transcript.
It lasted at least the team’s minimum length, 60 seconds by default.
A person answered it, unless the team turned this check off.

Team owners and admins change these rules, the facet weights and the scoring guidance under Settings → Coaching → Call scoring. Rescoring a call replaces its scorecard: _id stays the same and updatedAt changes. AI roleplay sessions are scored too, but this endpoint does not return them.

How the score is built

Each facet gets a score from 0 to 5. total_score scales each score to 100 and averages them by weight_pct, over the facets whose weight is above 0, and rounds to one decimal.

Facet	Default `weight_pct`	What it measures
`intro`	10	Permission-based opener
`discovery`	25	Questions and listening
`pitch`	20	Clarity and relevance of the pitch
`tonality`	15	Delivery and conversational control
`objection_handling`	15	Acknowledging, probing and resolving objections
`cta`	15	Securing the next step

With the default weights, facet scores of 4, 3.5, 3.5, 4, 3 and 3.5 (in table order) give a total_score of 71: (0.8 × 10) + (0.7 × 25) + (0.7 × 20) + (0.8 × 15) + (0.6 × 15) + (0.7 × 15). Teams can change the weights, turn a facet off, and add up to six custom facets:

A facet that is turned off is still scored, but its weight_pct is 0 and it does not count toward total_score.
Custom facets count toward total_score but are not returned by the API, so the six weights you see can add up to less than 100.

Read weight_pct from each scorecard rather than assuming the defaults. A scorecard keeps the weights in force when the call was scored. Other scales: gaps.skill, gaps.playbook, metadata.asr_confidence_avg, metadata.talk_listen_ratio_rep and the open_question_ratio fields run from 0 to 1.

Examples

# Newest scorecards first (the default order)
curl 'https://client-api.salesfinity.co/v1/scored-calls?limit=50' \
  --header 'x-api-key: YOUR_API_KEY'

# Highest scores first
curl 'https://client-api.salesfinity.co/v1/scored-calls?sort=-insight.total_score&limit=20' \
  --header 'x-api-key: YOUR_API_KEY'

# One rep's scorecards, lowest scores first
curl 'https://client-api.salesfinity.co/v1/scored-calls?user_id=64d2b3f2c4e3a6b8f2d9e1a7&sort=insight.total_score' \
  --header 'x-api-key: YOUR_API_KEY'

# Calls from the first week of October that scored below 50
curl 'https://client-api.salesfinity.co/v1/scored-calls?start_date=2026-10-01&end_date=2026-10-07T23:59:59Z&max_score=49' \
  --header 'x-api-key: YOUR_API_KEY'

start_date and end_date bound createdAt, and min_score and max_score bound insight.total_score; both ends are included. user_id must be a 24-character hex ID from Get the current team. Any other value is ignored, and every rep’s scorecards come back.

From a scorecard to its call

call_log._id is the call log’s ID: pass it to Get a call log for the full record, including the transcript. There is no filter that goes the other way, from a call log to its scorecard; page through this list and match call_log._id.

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

page

integer

default:1

Page number, 1-based.

Required range: x >= 1

limit

integer

default:10

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

Required range: 1 <= x <= 100

sort

string

Comma-separated field names; prefix - for descending. Default: -createdAt. Nested fields work, for example -insight.total_score for the highest scores first.

start_date

string<date-time>

The earliest createdAt to include, as an ISO 8601 date.

end_date

string<date-time>

The latest createdAt to include, as an ISO 8601 date.

min_score

number

The lowest insight.total_score to include, 0 to 100.

Required range: 0 <= x <= 100

max_score

number

The highest insight.total_score to include, 0 to 100.

Required range: 0 <= x <= 100

user_id

string

Only this rep's calls, by user _id from Get the current team. A value that is not a 24-character hex ID is ignored and every rep's calls come back.

Response

One page of scored calls.

data

object[]

Show child attributes

pagination

object

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List scored calls

Which calls are scored

How the score is built

Examples

From a scorecard to its call

Authorizations

Query Parameters

Response

​Which calls are scored

​How the score is built

​Examples

​From a scorecard to its call

Authorizations

Query Parameters

Response

Which calls are scored

How the score is built

Examples

From a scorecard to its call