Explain forecast confidence
POST/sales/forecasts/explain
Runs the forecast confidence engine and returns a human-readable explanation of how the AI-weighted pipeline forecast was calculated. Use this endpoint to surface confidence factors and assumptions in sales dashboards or when presenting forecasts to leadership.
Request
Request body
Content type application/json.
| Field | Type | Required | Description |
|---|---|---|---|
pipeline_id | integer, nullable | No | Scope the forecast explanation to a specific pipeline. Omit to use the default active pipeline. |
territory_id | integer, nullable | No | Further scope the explanation to a single territory. |
limit | integer | No | Maximum number of explanation factors to include in the response. Default: |
Example
{
"pipeline_id": 1,
"territory_id": 3,
"limit": 12
}Responses
200 Forecast confidence explanation with key factors
Content type application/json, any.
Example
{
"explanation": {
"pipeline_id": 1,
"territory_id": 3,
"weighted_total": 98500.0,
"confidence": 0.74,
"factors": [
{
"factor": "Historical win rate (90d)",
"value": 0.62,
"weight": 0.4
},
{
"factor": "Stage-weighted probability",
"value": 0.85,
"weight": 0.35
},
{
"factor": "Deal age penalty",
"value": 0.72,
"weight": 0.25
}
],
"notes": "Forecast excludes 3 deals with no expected close date."
}
}401 Unauthenticated
Example request
curl -X POST "https://{tenant}.faciotech.net/api/v1/sales/forecasts/explain" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"pipeline_id": 1, "territory_id": 3, "limit": 12}'