Score Companies

Get your HG AI Scores directly from the API — no need to export from the Platform or sync through Salesforce. Score companies against your account's scoring models, filter and rank companies by tier, and pull scores into your own workflow or CRM in real time.

• Programmatic target account lists — search and rank companies by score instead of exporting and sorting manually in the Platform UI
• Real-time scoring in your workflow — score a company the moment a record is created in your CRM or internal system
• Prioritize outbound — filter your existing pipeline by tier to focus on the highest-fit accounts first

• Your org has access to HG Platform to manage your scoring models
• The scoring entitlement on your account, on top of your regular API access

If you get a 422 saying scoring isn't available, or a 401 on these endpoints specifically, contact your account manager.

Search for companies scoring in your top tiers, then pull the full score breakdown and enrichment data for that list:

// 1. Search for A/B tier companies with 1,000+ employees
{
  "fields": ["id", "name", "domain"],
  "filters": {
    "firmographics": {"employees": {"min": 1000}},
    "scoring": {"model_id": "7e347cba", "tier": ["A", "B"]}
  },
  "sorts": [{"field": "total_score", "direction": "DESC"}],
  "limit": 25
}

// 2. Pull full scores for the returned company IDs
{
  "companies": {"ids": ["3AB6196C456CE3313A04A57BA6FA7BE3", "..."]},
  "model_ids": ["7e347cba"]
}

// 3. Enrich the same companies with firmographics, technographics, and spend
{
  "companies": {"ids": ["3AB6196C456CE3313A04A57BA6FA7BE3", "..."]},
  "fields": ["firmographics", "technographics", "spend"]
}

See Enrich Companies for the full list of available field groups.

Get every scoring model currently live in your account.

GET /data-api/v2/scoring/models

No parameters — returns all live models for your account. Draft models aren't included.

{
  "models": [
    {
      "model_id": "7e347cba",
      "model_name": "Enterprise ICP",
      "model_version_id": "b1c2d3e4",
      "version": 3
    }
  ],
  "count": 1
}

Filter and sort Company Search results by tier or score. This is the same "score-based segmentation" you'd do manually in the Platform's Companies view, now available as a filter.

{
  "fields": ["id", "name", "domain"],
  "filters": {
    "scoring": {
      "model_id": "7e347cba",
      "tier": ["A", "B"],
      "total_score": {"min": 70, "max": 100}
    }
  },
  "sorts": [{"field": "total_score", "direction": "DESC"}]
}

To sort by score, add total_score, fit_score, need_score, or intent_score to sorts — this requires filters.scoring.model_id to be set, and the score sort must be the first entry in sorts.

Search doesn't return the score values themselves — only companies matching the filter, with the standard fields you requested. To get the actual score numbers for those companies, pass their IDs to companies/score.

Score up to 25 companies against one or more models in a single call.

POST /data-api/v2/companies/score

{
  "companies": {
    "ids": ["3AB6196C456CE3313A04A57BA6FA7BE3"]
  },
  "model_ids": ["7e347cba"]
}

*Either ids or domains is required, but not both.

{
  "scores": [
    {
      "hg_id": "3AB6196C456CE3313A04A57BA6FA7BE3",
      "company_name": "Cisco Systems",
      "domain": null,
      "model_id": "7e347cba",
      "model_name": "Enterprise ICP",
      "model_version_id": "b1c2d3e4",
      "tier": "A",
      "total_score": 87,
      "fit_score": 90,
      "need_score": 72,
      "intent_score": 60,
      "is_disqualified": false
    }
  ],
  "count": 1
}

You get one row per company per model. If a company isn't scored under a given model, that row's score fields come back null instead of erroring — the request as a whole still succeeds.

None of the scoring endpoints consume credits.