Skip to main content

When to use resolve vs enrich

resolve is cheaper than enrich per matched record. Both run the same matching logic — the difference is what comes back.

Parameters

records
list[dict]
required
Up to 500 per call. Each must have record_id + at least one matching field (LinkedIn URL, emails, name, etc.).
version
str
default:"\"v2\""
API version.
match_condition_fields
list[str]
Quality gate. A record only counts as a match if the resolved person actually has these fields. Up to 3.
dry_run
bool
default:"False"
Validate input locally without sending. Returns the ResolveRequest that would be sent. See Validation.

Response shape

match.results is a list of ResolveResult objects with record_id, is_match, minerva_pid, match_score. The response is typed end-to-end — IDE autocomplete + mypy will check field access for you.

Tabular output

See Output formats for full conversion patterns.

Limits

  • Records per call: 500
  • Validation enforced locally before the call — over-limit records raise MinervaValidationError without a round-trip
  • Billing: see your plan for per-resolve / per-match pricing