Skip to main content
GET
Get average first response time

Overview

Get the average time it takes for your team to send the first response to new customer messages within a specific date range. This critical metric helps you measure customer service quality and SLA compliance. First response time is one of the most important customer service metrics, directly impacting customer satisfaction and retention.

Use Cases

  • SLA Monitoring: Track compliance with response time SLAs
  • Customer Satisfaction: Monitor key customer experience metric
  • Team Performance: Measure overall team responsiveness
  • Trend Analysis: Compare first response times across different periods
  • Improvement Tracking: Monitor the impact of process changes
  • Reporting: Generate executive reports on customer service quality

Authentication

This endpoint requires authentication using an API key. Include your API key in the request header:

Query Parameters

Default Range: If no dates provided, returns data for the last 7 days.

Response Structure

Example Requests

Get Last 7 Days (Default)

Get Specific Date Range

Filter by Pipeline and Team Members

Example Response

This means the average first response time is 300 seconds (5 minutes).

Common Use Cases

1. Display Response Time Metric

2. Compare Different Time Periods

3. SLA Compliance Check

4. Compare Team Member Performance

5. Weekly Performance Report

Date Format

Dates should be in ISO 8601 format (YYYY-MM-DD):
  • โœ… Correct: "2024-09-30"
  • โœ… Correct: "2024-01-15"
  • โŒ Incorrect: "09/30/2024"
  • โŒ Incorrect: "30-09-2024"

Time Zone Considerations

  • Dates are interpreted in your accountโ€™s configured time zone
  • Response time calculations respect your business hours
  • Default date range: Last 7 days from current time

Error Responses

Performance Benchmarks

Typical first response time benchmarks:

Notes

  • First Response Only: Measures time to FIRST team member response per conversation
  • Team Average: Aggregates across all team members (or filtered subset)
  • Seconds Unit: Response time returned in seconds
  • Default Period: Last 7 days if no dates specified
  • Business Impact: Lower times generally correlate with higher satisfaction

Headers

x-api-key
string
required

API key

Query Parameters

startDate
string

Start date (ISO 8601). Defaults to today-7d 00:00.

Example:

"2025-05-27"

endDate
string

End date (ISO 8601). Defaults to today 23:59.

Example:

"2025-06-03"

agentIds
string[]

Optional array of agent IDs to filter by specific agents

Example:
pipelineId
string

Optional pipeline ID to filter by specific pipeline

Example:

"pipeline-id-1"

stageIds
string[]

Optional array of stage IDs to filter by specific stages

Example:
hideArchived
boolean

Optional boolean to filter by archived conversations

Example:

true

hideUnassigned
boolean

Optional boolean to filter by unassigned conversations

Example:

true

Response

200 - application/json

Successfully retrieved average first response time

averageFirstResponseTime
number

Average first response time in seconds

Example:

300