Enhanced enrichment with direct lookups, flexible matching, and selective field returns
minerva_pid or linkedin_url for instant results without fuzzy matchingreturn_fields to get only the data you need and optimize response sizerelatives field with family relationship informationlinkedin_url, gender, estimated_income_range, estimated_wealth_range, email, personal_email, professional_email, phone, mobile_phone, home_ownership_statusExample: ["email"] or ["phone", "linkedin_url"]record_id, is_match, minerva_pid, match_score, validation_errorsAvailable fields: full_name, first_name, middle_name, last_name, name_suffix, gender, dob, age, marital_status, minerva_household_id, minerva_spouse_pid, number_of_children, is_retired, estimated_income_range, estimated_wealth_range, home_ownership_status, linkedin_url, linkedin_title, linkedin_industry, is_likely_remote_worker, facebook_url, twitter_url, has_bankruptcy_records, has_judgment_records, address_history, education_experience, work_experience, personal_emails, professional_emails, phonesNote: When using return_fields, only the requested fields are included, but they are returned within their respective nested objects (personal_information, household_information, financial_information, social_media). The relatives field is automatically included when returning all fields, but cannot be explicitly requested via return_fields.Example: ["full_name", "personal_emails", "phones"]record_id (string, required): Your unique identifier for this recordminerva_pid (string): New in V2 - Direct Minerva Person ID lookup for instant enrichment. Format: p- followed by 32 hexadecimal characterslinkedin_url (string): New in V2 - LinkedIn profile URL or username for direct enrichmentfirst_name (string): Person’s first namemiddle_name (string): Person’s middle namelast_name (string): Person’s last namefull_name (string): Person’s full namename_suffix (string): Name suffix (e.g., “Jr.”, “Sr.”, “III”)emails (array): Array of email addressesphones (array): Array of phone numbers/v2/enrich accepts minerva_pid and linkedin_url as direct lookup fields, while /v2/resolve does not.
return_fields)return_fields: ["full_name", "linkedin_url", "personal_emails"], only the requested fields are returned alongside the base fields:
400 - Bad Request: Missing required fields or malformed JSON401 - Unauthorized: Invalid or missing API key413 - Payload Too Large: More than 500 records in request422 - Unprocessable Entity: Validation errors in record data, invalid match_condition_fields, or invalid return_fields500 - Internal Server Error: Unexpected server errorminerva_pid field (format: p- + 32 hex characters)minerva_pid takes precedence over all other fieldslinkedin_url field (full URL or username)minerva_pid is not providedhttps://www.linkedin.com/in/username) and usernames (username)first_name and last_name (or full_name)record_id (required)minerva_pid (required for this mode)record_id (required)linkedin_url (required for this mode)minerva_pid providedrecord_id (required)first_name AND last_name) OR full_nameemails or phonesreturn_fields to request only needed data - significantly reduces response size and improves latencyminerva_pid) are fastest - use when you have previously resolved a person/v2/resolve due to enriched data volume)match_condition_fields filters results to only return matches that have the specified fields populatedlinkedin_url, gender, estimated_income_range, estimated_wealth_range, email, personal_email, professional_email, phone, mobile_phone, home_ownership_status["email", "linkedin_url"] will only return matches that have both an email and LinkedIn profile[] if no data is availablerelatives field is included in full responses but is not available as an explicit return_fields optionpersonal_information, household_information, financial_information, and social_mediareturn_fields, only requested fields are included within their respective nested objectsminerva_pid must be in format: p- followed by exactly 32 hexadecimal characterslinkedin_url accepts full URLs or just the username portionvalidation_errors populated and may have is_match: falseminerva_pid and linkedin_url as input fields for instant enrichmentpersonal_information, household_information, financial_information, social_media)relatives field provides family relationship data with linked Minerva PIDsreturn_fields allows precise control over response payload for cost optimization/v1/enrich → /v2/enrichpersonal_information: Contains name, gender, DOB, age, marital statushousehold_information: Contains household ID, spouse PID, number of childrenfinancial_information: Contains income/wealth estimates, home ownership, bankruptcy/judgment recordssocial_media: Contains LinkedIn, Facebook, Twitter URLs and professional detailsaddress_history, work_experience, education_experience, personal_emails, professional_emails, phones, relatives) remain at the top levelminerva_pid to your input records if you have previously resolved personslinkedin_url if you have LinkedIn profilesreturn_fields to request only needed data
record_id, is_match, minerva_pid, match_score, validation_errorsmatch_condition_fields to ensure matches have required datarelatives field now provides family relationship information/v2/resolve/v2/enrich accepts minerva_pid and linkedin_url as INPUT fields for direct lookups/v2/resolve does NOT accept these fields as inputs (uses reverse lookup instead via single email/phone)/v2/enrich requires record_id to be provided/v2/resolve has optional record_id/v2/enrich returns comprehensive enrichment data/v2/resolve only returns match information and LinkedIn URL