Skip to main content
GET
/
reporting
/
general
Retrieve general conversation statistics
curl --request GET \
  --url https://api.getfernand.com/reporting/general \
  --header 'X-API-Key: <api-key>'
{
  "inbox": {},
  "assigned": {},
  "closed": {},
  "responded": {},
  "resolved": {},
  "ttfr": {},
  "ttr": {}
}
Returns comprehensive conversation metrics broken down by date, channel, source, and agent. Data can be filtered by date range, tag, and aggregated by custom intervals (hours, days, weeks, months, years).

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Query Parameters

​
start
string<date>
required

Start date for the statistics range in YYYY-MM-DD format.

​
end
string<date>
required

End date for the statistics range in YYYY-MM-DD format.

​
interval
enum<string>

Granularity of the time-based aggregation. If not specified, automatically determined based on date range (<=3 days=hours, <=31 days=days, <=90 days=days, >90 days=months).

Available options:
hours,
days,
weeks,
months,
years
​
tag
string

Filter statistics to only conversations with this tag slug.

Response

Statistics retrieved successfully.

​
inbox
object

Number of conversations created, grouped by date with breakdowns by channel, source, and assigned agent.

​
assigned
object

Number of conversations assigned to an agent, grouped by date with breakdowns by channel, source, and agent.

​
closed
object

Number of conversations closed, grouped by date with breakdowns by channel, source, and closing agent.

​
responded
object

Number of conversations that received first response, grouped by date with breakdowns by channel, source, and responding agent.

​
resolved
object

Number of conversations resolved, grouped by date with breakdowns by channel, source, and resolving agent.

​
ttfr
object

Average time to first response in seconds, grouped by date with breakdowns by channel, source, and responding agent.

​
ttr
object

Average time to resolution in seconds, grouped by date with breakdowns by channel, source, and resolving agent.