ListHistoricalData

POST

https://api.cbf.tcn.com/api/v1alpha1/wfm/listhistoricaldata

Gets the historical data for the org sending the request and the given @skill_profile_category.
It will look through the client's call history and generate the historical data by using their configured forecasting parameters (historical data period and interval width).
The duration of each interval will be the interval width of the org's forecasting parameters.
It also applies any deltas that the client has stored for the given @skill_profile_category, if the category is a group it will use the deltas of the skill profiles part of that group.
If the client has no historical data, only the deltas will be applied to the returned intervals, all other intervals will have nil averages.
Errors:

grpc.Invalid: the @skill_profile_category in the request is invalid.

grpc.NotFound: the @skill_profile_category given is not found for the org.

grpc.Internal: error occurs when getting the historical data.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cbf.tcn.com/api/v1alpha1/wfm/listhistoricaldata' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200OK

application/json

Success

Body

Example

🔴500Server Error

Modified at 2025-08-14 21:02:57

GetClientHistoryCacheInfo

UpsertHistoricalDataDelta