# Score Companies

Scores up to 25 companies against up to 6 of your organization's live AI scoring models.
Identify companies by `ids` or `domains`, exactly as `companies/enrich` does. Returns one
row per company per model; a company that is not scored by a model comes back with null
scores rather than failing the request.

Endpoint: POST /data-api/v2/companies/score
Security: authorization

## Security:

  - `authorization` (unknown)
    http bearer API_KEY

## Request body:

  - `application/json` (unknown)
    Score Request

## Request fields (application/json):

  - `companies` (object, required)
    Filter companies by IDs or domains (mutually exclusive)
    Example: {"ids":["E48EDEB162A5FBFDAF2DCF707079F8F","1698C53EBC888758570396E0334965C1"]}

  - `companies.domains` (array)
    Array of company domains (e.g., example.com)

  - `companies.ids` (array)
    Array of hex-encoded company IDs

  - `model_ids` (array)
    Model ids from GET /v2/scoring/models. Omit to score against every live model; if the organization has more than 6, naming them is required.

## Response 200:

  - `200` (unknown)
    Score Response

## Response 200 fields (application/json):

  - `count` (integer, required)
    Number of rows returned

  - `scores` (array, required)

  - `scores.company_name` (string)
    Company name

  - `scores.domain` (string)
    The domain the caller sent; null when the request used ids

  - `scores.fit_score` (integer)
    Firmographic fit

  - `scores.hg_id` (string)
    HG company identifier

  - `scores.intent_score` (integer)
    Research + buyer activity

  - `scores.is_disqualified` (boolean)
    True when tier is DQ

  - `scores.model_id` (string)
    Scoring model identifier

  - `scores.model_name` (string)
    Current name of the model

  - `scores.model_version_id` (string)
    Published version that produced this score

  - `scores.need_score` (integer)
    Technographic need

  - `scores.tier` (string)
    Score tier; null when not scored
    Enum: "A", "B", "C", "D", "F", "DQ"

  - `scores.total_score` (integer)
    Weighted blend of Fit + Need + Intent

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: The api key provided is not valid

  - `errors.source` (string)

  - `errors.title` (string, required)
    Example: Unauthorized

## Response 422:

  - `422` (unknown)
    Unprocessable Entity

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.detail` (string, required)
    Example: null value where string expected

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)
    Example: /data/attributes/petName

  - `errors.title` (string, required)
    Example: Invalid value