Skip to content
HALOWERK

Signalwerk

lead score explain

Works only on the supplied data and the disclosed rules – no external data, no model. Each rule names a field (dot path), an operator (eq, ne, in, not_in, gt, gte, lt, lte, between, exists, missing, contains, contains_any, starts_with, ends_with; strings compared case-insensitively), a value and points (negative allowed) or knockout. A rule whose field is missing is not counted as false but listed under data_gaps with the points at stake. score = sum of matched points, score_pct = score /.

POST https://signal.halowerk.com/v1/lead-score-explain

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
leadsarrayYesLead records, e.g. enrichment rows.
rulesarrayYes
thresholdsobjectNoGrade thresholds on score_pct (defaults 75/50/25).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "leads",
    "rules"
  ],
  "properties": {
    "leads": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "object"
      },
      "description": "Lead records, e.g. enrichment rows."
    },
    "rules": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "field",
          "op"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 60
          },
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Dot path into the lead, e.g. employees or company.country."
          },
          "op": {
            "type": "string",
            "enum": [
              "eq",
              "ne",
              "in",
              "not_in",
              "gt",
              "gte",
              "lt",
              "lte",
              "between",
              "exists",
              "missing",
              "contains",
              "contains_any",
              "starts_with",
              "ends_with"
            ]
          },
          "value": {
            "description": "Comparison value (array for in/not_in/contains_any/between)."
          },
          "points": {
            "type": "number",
            "minimum": -1000,
            "maximum": 1000,
            "description": "Points when the rule matches (ignored for knockouts)."
          },
          "knockout": {
            "type": "boolean",
            "description": "A match disqualifies the lead."
          },
          "group": {
            "type": "string",
            "maxLength": 40,
            "description": "Optional subtotal group such as fit or intent."
          }
        }
      }
    },
    "thresholds": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "A": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "B": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "C": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      },
      "description": "Grade thresholds on score_pct (defaults 75/50/25)."
    }
  }
}

Open original schema

Published input example

{
  "leads": [
    {
      "domain": "muster.de",
      "employees": 120,
      "country": "DE"
    }
  ],
  "rules": [
    {
      "field": "employees",
      "op": "between",
      "value": [
        50,
        500
      ],
      "points": 30,
      "label": "Mid-sized"
    },
    {
      "field": "country",
      "op": "in",
      "value": [
        "DE",
        "AT",
        "CH"
      ],
      "points": 20
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →