Skip to main content

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 (up to 3). A record only counts as a match if the resolved person actually has these fields. Useful when you need contact info you can act on (e.g. require a phone). Omit to match on resolution alone.
return_fields
list[str]
Narrow the response payload to just these fields. Reduces wire size; doesn’t affect billing.
dry_run
bool
default:"False"
Validate input locally without sending. Returns the EnrichRequest that would be sent. See Validation.

Response shape

Each result includes:
match_condition_fields is a quality gate — a record only counts as a match if the resolved person actually has those fields (e.g. require a phone you can dial). Omit it to match on resolution alone.

Tabular output

Nested fields (e.g. personal_information.full_name) flatten into top-level columns in the DataFrame. See Output formats.

Map onto your own schema

Project any result onto your pydantic model — missing fields become None (with a one-time warning), so it never breaks:

Limits

  • Records per call: 500
  • Validation enforced locally before the call — over-limit records raise MinervaValidationError without a round-trip
  • Billing: credits consumed per matched record — see your plan