match_person

match_person resolves people through OnFire’s matching engine. Vector search and AI matching handle “Lana P. at Snowflake” or just an email alias, and return the verified LinkedIn profile, job title, and current company.

When to use it

• You have a person but no LinkedIn URL and want to enrich or query them.
• A list of CRM contacts needs LinkedIn URLs before contact_data_enrichment.
• The user explicitly asks you to verify that someone still works there.

Skip it when you already have a person LinkedIn URL — from the user, a CRM row, or another OnFire tool (signal rows carry intent_holder_linkedin_url). That URL is the canonical identifier; feed it straight into the downstream tool.

Inputs

Single-person shortcut — pass the fields directly:

Parameter	Type	Description
person_full_name	string	e.g. "John Smith".
person_email	string	e.g. "john@acme.com".
company_name	string	e.g. "Acme Inc".
job_title	string	Improves match accuracy.
company_linkedin_url	string	Improves match accuracy.
company_website	string	Improves match accuracy.

Batch form:

Parameter	Type	Required	Description
entities	object[]	Yes	Up to 100 person descriptors, any combination of the fields above.
confirmed	boolean	No	Required true for batches over 50.

Minimum per person: at least one of person_full_name or person_email. With a name and no email, company_name is required.

Returns

JSON with total_count, matched_count, and a results array in input order. Each record carries matched, linkedin_url, full_name, job_title, company_name, company_linkedin_url, company_website, match_score, and match_type.

A batch also returns a dataset handle — filter linkedin_url with from_dataset + column in ask_onfire instead of re-typing the URLs.

Example

{
  "entities": [
    { "person_full_name": "John Smith", "company_name": "Acme Inc" },
    { "person_full_name": "Jane Doe", "person_email": "jane@techcorp.com", "company_name": "TechCorp" },
    { "person_email": "ceo@startup.io" }
  ]
}

Notes & limits

• Batch up to 100 entities per call; over 50 returns needs_confirmation (nothing runs) so the volume can be settled first.
• A successful match usually returns the company LinkedIn URL too — reuse it for downstream prospecting calls.