Skip to main content

Scoring API

Scoring Profile

GET /api/settings/scoring-profile
PUT /api/settings/scoring-profile
Manages the per-org scoring profile (org_scoring_profiles) including:
  • ICP company fit tiers and segment weights
  • ICP persona rules and title tiers
  • Behavioral, demographic, and engagement scoring weights
  • MQL qualification triggers
  • ICP firmographic criteria
  • Pipeline and forecast settings

Calibration

GET /api/calibration
POST /api/calibration
The calibration endpoint allows admins to:
  • View current scoring weights and thresholds
  • Adjust category weights (engagement, fit, intent, velocity, pipeline_health, relationship, risk, opportunity_quality)
  • Override individual rule weights
  • Test score impact with sample accounts

Score Decomposition

Scores returned by the engine include full decomposition:
FieldDescription
compositeScoreOverall 0-100 score
categoryScoresArray of per-category scores with weights
ruleResultsArray of individual rule results
metadata.totalRulesEvaluatedRules run
metadata.totalRulesTriggeredRules that fired
metadata.durationMsComputation time
modelVersionEngine version
computedAtISO timestamp