Skip to content

Get quality stats

GET
/api/workspaces/{workspaceId}/quality/stats

Retrieve aggregate quality statistics for a workspace over a given period.

workspaceId
required
string format: uuid

The workspace to get quality stats for.

period
string

Predefined period: last_7d, last_30d, last_90d (default last_30d).

from
string

Start of custom range in ISO 8601 format (overrides period).

to
string

End of custom range in ISO 8601 format (overrides period).

Quality statistics for the requested period.

Aggregate quality statistics for a workspace over a given period.

object
periodStart
required

Start of the statistics period.

string format: date-time
Example
2026-02-24T00:00:00.000Z
periodEnd
required

End of the statistics period.

string format: date-time
Example
2026-03-25T23:59:59.999Z
conversationsScored
required

Number of conversations that received a quality score in the period.

integer
Example
312
averageComposite
required

Average composite CSAT score (1.0 to 5.0).

number
Example
4.21
averageOutcome
required

Average outcome dimension score.

number
Example
4.35
averageProcess
required

Average process dimension score.

number
Example
4.18
averageEnvironment
required

Average environment dimension score.

number
Example
4.1
averageConfidence
required

Average confidence of the computed scores (0.0 to 1.0).

number
Example
0.82
averageDisconfirmation
required

Average disconfirmation gap (0.0 to 1.0, lower is better).

number
Example
0.14
circuitBreakersTriggered
required

Number of circuit breakers triggered during the period.

integer
Example
1
resolutionRate
required

Fraction of conversations that reached a resolution.

number
Example
0.91