qualify_firm

Is this firm in my ICP? POST /v1/decisions/qualify_firm. $0.005 per answer. Scope decisions:write.

When to call

Call it when your agent meets a company and must decide whether to spend effort on it: before enrichment, before research, before writing. One call replaces a lookup plus a model prompt. Do not call it twice for the same firm and ICP in a short window; the answer will not change until the index or your thresholds do.

Inputs

Give one firm reference and an ICP id. A domain is the easiest reference. A name works best with a country hint. Identifiers (lei, cik, crd, companies_house, firm_id) resolve exactly.

Field	Type	Required	Description
`firm`	FirmReference	yes	A firm reference: exactly one of `firm_id`, `domain`, `name` (with an optional `hint`), `lei`, `cik`, `crd` or `companies_house`.
`firm.firm_id`	string	no	A firm id from Verdict’s index.
`firm.domain`	string	no	The firm’s web domain.
`firm.name`	string	no	The firm’s legal or trading name.
`firm.hint`	object	no	Optional country, city or domain to disambiguate the name.
`firm.hint.country`	string	no	ISO 3166-1 alpha-2 country of the firm’s headquarters.
`firm.hint.city`	string	no	City of the firm’s headquarters.
`firm.hint.domain`	string	no	A domain the firm is known to use.
`firm.lei`	string	no	The firm’s Legal Entity Identifier.
`firm.cik`	string	no	The firm’s SEC Central Index Key.
`firm.crd`	string	no	The firm’s CRD number.
`firm.companies_house`	string	no	The firm’s UK Companies House number.
`icp_id`	string	yes	The ICP profile to decide against.

Outputs

The common envelope (see Decisions) plus:

fit: the same value as p.
answer: fit when p clears your threshold, else not_fit.
firm: the resolved firm: id, name, domain, identifiers, type, size_band and hq.

Reason codes

`reason_code`	Meaning
`icp_type_and_size_match`	The firm’s type and size band both match the ICP.
`icp_type_match_size_mismatch`	The firm’s type matches the ICP but its size band is outside the ICP’s range.
`icp_size_match_type_mismatch`	The firm’s size band matches the ICP but its type is not one the ICP targets.
`icp_type_and_size_mismatch`	Neither the firm’s type nor its size band matches the ICP.
`icp_geography_mismatch`	The firm’s headquarters are outside the ICP’s geography.
`icp_exclusion_filter_match`	The firm matches one of the ICP’s structured exclusion filters.
`firm_inactive`	Public registries show the firm as dissolved or inactive.
`insufficient_firm_data`	Too few public facts are indexed for the firm to judge fit with confidence.

Cost

$0.005 when an answer is returned. A firm that cannot be resolved returns 404 not_found and bills nothing. Errors bill nothing.

Example

curl -X POST 'https://api.askverdict.io/v1/decisions/qualify_firm' \
  -H "Authorization: Bearer $VERDICT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{
  "firm": {
    "domain": "northfieldcapital.com"
  },
  "icp_id": "icp_01JC3Z4Y8R9K2M5N7P1Q3S5T7V"
}'

{
  "id": "dec_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
  "version": "2026-11-01",
  "question_set_version": "2026-11-01",
  "model": "jev",
  "calibration": {
    "basis": "org",
    "n_outcomes": 412,
    "threshold": 0.6
  },
  "latency_ms": 180,
  "created_at": "2026-11-07T14:03:00Z",
  "decision": "qualify_firm",
  "p": 0.82,
  "answer": "fit",
  "reason_code": "icp_type_and_size_match",
  "reason": "Registered investment adviser, $400M AUM band, 12 employees; matches ICP type and size.",
  "evidence": [
    {
      "source": "sec_edgar",
      "url": "https://adviserinfo.sec.gov/firm/summary/298765",
      "observed_at": "2026-10-28",
      "label": "Form ADV Part 1A"
    }
  ],
  "fit": 0.82,
  "firm": {
    "id": "frm_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
    "name": "Northfield Capital Advisors LLC",
    "domain": "northfieldcapital.com",
    "identifiers": {
      "crd": "298765",
      "lei": "549300ABCDEF12345678"
    },
    "type": "investment_adviser",
    "size_band": "small",
    "hq": {
      "country": "US",
      "region": "MA",
      "city": "Boston"
    },
    "status": "active"
  },
  "cost": {
    "decision_usd": 0.005,
    "vendor_usd": 0,
    "total_usd": 0.005
  },
  "balance_usd": 18.32
}

Then

Report what happened with POST /v1/outcomes: approved or skipped from your own review, then replied or meeting_booked later. See the eval results for this decision’s precision and recall.