Skip to main content
GET
List call performance by SDR
Returns call metrics grouped by SDR (Sales Development Representative) with pagination. Use this endpoint to analyze individual user performance.

Query Parameters

  • start_date (optional, date): Start date for the analytics period. Accepts ISO 8601 format. If omitted, defaults to 7 days before end_date.
    • Examples:
      • 2024-01-01T00:00:00.000Z - ISO 8601 with UTC timezone
      • 2024-01-01 - Simple date format (YYYY-MM-DD)
      • 2024-01-01T00:00:00-05:00 - ISO 8601 with timezone offset
  • end_date (optional, date): End date for the analytics period. Accepts ISO 8601 format. If omitted, defaults to the current date.
    • Examples:
      • 2024-01-31T23:59:59.999Z - ISO 8601 with UTC timezone
      • 2024-01-31 - Simple date format (YYYY-MM-DD)
      • 2024-01-31T23:59:59-05:00 - ISO 8601 with timezone offset
  • user_ids (optional, array of strings): Filter by specific user IDs.
    • Example: ["64d2b3f2c4e3a6b8f2d9e1a7"]
  • disposition_ids (optional, array of numbers): Filter by disposition IDs (1=Meeting Set, 2=No Longer With Company, 3=Not Interested, etc.).
    • Example: [1, 2, 3]
  • timezone (optional, string): Timezone for date calculations.
    • Example: America/New_York
  • page (optional, number): Page number (default: 1).
    • Example: 1
  • limit (optional, number): Items per page (default: 10, max: 100).
    • Example: 10
  • search (optional, string): Search by SDR name or email.

Response

Returns a paginated list of SDR performance metrics. Metrics per SDR:
  • _id - User ID
  • first_name - SDR first name
  • last_name - SDR last name
  • email - SDR email
  • image - Profile image URL
  • total_calls - Total calls made
  • connected_calls - Connected calls
  • connection_rate - Ratio of connected to total calls (0-1)
  • conversations - Meaningful conversations
  • conversation_rate - Ratio of conversations to total calls (0-1)
  • avg_dials_day - Average dials per active day
  • total_duration - Total call duration in seconds
  • meetings_set - Number of meetings set
  • data_quality - Data quality ratio (0-1)

Authorizations

x-api-key
string
header
required

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

Query Parameters

start_date
string<date>

Start date for the analytics period (ISO 8601). Examples: 2024-01-01, 2024-01-01T00:00:00.000Z, 2024-01-01T00:00:00-05:00. If omitted, defaults to 7 days before end_date.

end_date
string<date>

End date for the analytics period (ISO 8601). Examples: 2024-01-31, 2024-01-31T23:59:59.999Z, 2024-01-31T23:59:59-05:00. If omitted, defaults to the current date.

user_ids
string[]

Filter by specific user IDs

disposition_ids
integer[]

Filter by disposition IDs (1-14)

timezone
string

IANA timezone for date calculations (e.g., America/New_York)

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:10

Items per page

Required range: 1 <= x <= 100

Search by SDR name or email

Response

SDR performance retrieved successfully

totalCount
integer
required
data
object[]
required
page
integer
required
limit
integer
required
next
integer | null
prev
integer | null