Parameters
list[dict]
required
Up to 500 per call. Each record must include
record_id and satisfy one of
the Enrich input rules supported by the Python
SDK.str
default:"\"v2\""
API version.
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.list[str]
Narrow the response payload to just these fields. Reduces wire size; doesn’t
affect billing.
Add a
premium_fields object to each matched result with separately-licensed
household, spending, vehicle, travel, and interest attributes. Requires the
api:premium-fields entitlement — without it the call fails with 403. v2
only; the flag is dropped when you pin version="v1".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
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 becomeNone (with a one-time warning), so it never breaks:
Limits
- Records per call: 500
- Validation enforced locally before the call — over-limit records raise
MinervaValidationErrorwithout a round-trip - Billing: credits consumed per matched record — see your plan