pick_person

Who at this firm should I write to? POST /v1/decisions/pick_person. $0.005 per call, for up to 50 people. Scope decisions:write.

When to call

Call it when you have a list of people at one firm and must choose whom to contact. Bring the roster from your own source. Verdict never uses LinkedIn data and does not need it: name, title, seniority and department are enough.

Inputs

Field	Type	Required	Description
roster	array of RosterEntry	yes	The people to rank, 1 to 50.
roster[].ref	string	no	Your own id for this person, echoed back in people.
roster[].name	string	yes	Full name.
roster[].title	string	yes	Job title.
roster[].seniority	enum: “owner”, “c_level”, “vp”, “director”, “manager”, “senior”, “entry”, “unknown”	no	Seniority, if known.
roster[].department	string	no	Department or function, for example Operations.
roster[].location	string	no	City or country.
roster[].tenure_months	integer	no	Months in the current role.
firm	FirmReference	no	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.
question	string	no	Optional extra question, for example who owns trading operations?.

Give each person a ref of your own so you can map the ranking back. Add an optional question to steer the choice, for example who owns trading operations?.

Outputs

The common envelope plus people: the roster ranked, each entry with ref, index, rank and p. p on the envelope is the top person’s. answer is pick when the top person clears your threshold, else no_pick: nobody on this roster is a good fit.

Reason codes

reason_code	Meaning
buyer_role_match	The top-ranked person’s title and department match the ICP’s buyer role.
seniority_match	The top-ranked person’s seniority fits the decision authority the offer needs.
influencer_role_match	The best match is an adjacent role likely to influence, not own, the purchase.
question_match	The top-ranked person best matches the caller’s own question.
too_senior_for_offer	The strongest title matches are more senior than the offer usually needs.
too_junior_for_offer	The strongest title matches are more junior than the offer usually needs.
titles_ambiguous	Roster titles are too vague to rank with confidence.
no_strong_match	No one in the roster is a strong match; the ranking is best effort.

Cost

$0.005 per call, whatever the roster size up to 50. Errors bill nothing. Rosters over 50 are refused with 400 invalid_request.

Example

Request

curl -X POST 'https://api.askverdict.io/v1/decisions/pick_person' \
  -H "Authorization: Bearer $VERDICT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{
  "roster": [
    {
      "ref": "c-101",
      "name": "Dana Whitfield",
      "title": "Chief Operating Officer",
      "seniority": "c_level",
      "department": "Operations"
    },
    {
      "ref": "c-102",
      "name": "Sam Ortega",
      "title": "Operations Associate",
      "seniority": "entry",
      "department": "Operations"
    },
    {
      "ref": "c-103",
      "name": "Priya Raman",
      "title": "Chief Compliance Officer",
      "seniority": "c_level",
      "department": "Compliance"
    }
  ],
  "firm": {
    "domain": "northfieldcapital.com"
  },
  "icp_id": "icp_01JC3Z4Y8R9K2M5N7P1Q3S5T7V"
}'

Response 200

{
  "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": "pick_person",
  "p": 0.74,
  "answer": "pick",
  "reason_code": "buyer_role_match",
  "reason": "Chief Operating Officer owns operations tooling at a 12-person adviser.",
  "evidence": [
    {
      "source": "request",
      "url": null,
      "observed_at": "2026-11-07",
      "pointer": "/roster/0"
    }
  ],
  "people": [
    {
      "index": 0,
      "ref": "c-101",
      "rank": 1,
      "p": 0.74
    },
    {
      "index": 2,
      "ref": "c-103",
      "rank": 2,
      "p": 0.41
    },
    {
      "index": 1,
      "ref": "c-102",
      "rank": 3,
      "p": 0.09
    }
  ],
  "cost": {
    "decision_usd": 0.005,
    "vendor_usd": 0,
    "total_usd": 0.005
  },
  "balance_usd": 18.31
}