Base Fields These fields are always returned in every response, regardless of return_fields settings.
Field Type Description record_idstring Your unique identifier from the request is_matchboolean Whether a match was found for this record minerva_pidstring Minerva person identifier (format: p- + 32 hex characters) match_scorenumber Confidence score for the match (0-1 scale, higher = more confident) validation_errorsobject Any validation errors from the input (null if none)
Contained within the personal_information object.
Field Type Description Example Values full_namestring Person’s complete name "JOHN M SMITH"first_namestring First name "JOHN"middle_namestring Middle name or initial "M"last_namestring Last name / surname "SMITH"name_suffixstring Name suffix "Jr.", "Sr.", "III"genderstring Gender "M", "F", or nulldobstring Date of birth "1990-01-15" (YYYY-MM-DD)ageinteger Current calculated age 34marital_statusstring Marital status "M" (married), "S" (single), or null
Contained within the household_information object.
Field Type Description minerva_household_idstring Unique household identifier minerva_spouse_pidstring Spouse’s Minerva PID (if available) number_of_childreninteger Number of children in household
Contained within the financial_information object.
Field Type Description Example Values is_retiredboolean Whether the person is retired true, falseestimated_income_rangestring Estimated annual income bracket "$101K - $250K"estimated_wealth_rangestring Estimated total wealth bracket "$1M-$2M"home_ownership_statusstring Home ownership status "Owner", "Renter", or nullhas_bankruptcy_recordsboolean Whether bankruptcy records exist true, falsehas_judgment_recordsboolean Whether court judgment records exist true, false
Contained within the social_media object.
Field Type Description linkedin_urlstring LinkedIn profile URL linkedin_titlestring Current title from LinkedIn profile linkedin_industrystring Industry listed on LinkedIn is_likely_remote_workerboolean Whether the person likely works remotely facebook_urlstring Facebook profile URL twitter_urlstring Twitter/X profile URL
Personal Emails Array of personal email addresses. Each email object contains:
Field Type Description email_rankinteger Priority ranking (1 = highest priority / most reliable) email_addressstring The email address
Professional Emails Array of work/professional email addresses. Each email object contains:
Field Type Description email_rankinteger Priority ranking (1 = highest priority / most reliable) email_addressstring The email address
Phone Numbers Array of phone numbers. Each phone object contains:
Field Type Description Example Values phone_rankinteger Priority ranking (1 = highest priority) 1, 2, 3phone_typestring Type of phone line "Mobile", "Landline"phone_numberstring Formatted phone number "(555) 123-4567"
Family Relationships The relatives array contains family relationship information. Each relative object contains:
Field Type Description Example Values relative_minerva_pidstring Minerva PID of the relative "p-b2c3d4..."relative_first_namestring Relative’s first name "ROBERT"relative_last_namestring Relative’s last name "SMITH"relationship_labelstring Type of relationship "child-parent", "sibling", "spouse"relationship_sublabelstring Additional relationship details "son-father", "brother-sister"
The relatives field is automatically included when returning all fields, but cannot be explicitly requested via the return_fields parameter.
Address History Array of address records ordered by recency. Each address object contains:
Core Address Fields Field Type Description address_rankinteger Recency rank (1 = most recent / current address) minerva_address_idstring Unique address identifier address_line_1string Street address address_line_2string Apartment, suite, or unit number address_citystring City name address_statestring State abbreviation address_zipcodestring 5-digit ZIP code address_zipcode4string ZIP+4 extension
Ownership & Residency Field Type Description Example Values ownership_statusstring Whether property is owned or rented "Owned", "Rented", "Unknown"is_current_ownerboolean Whether person currently owns this property true, falsefirst_seen_datestring First date person was associated with address "2018-08-01"last_seen_datestring Last date person was associated with address "2023-09-30"
Property Details Field Type Description Units purchase_datestring Date property was purchased YYYY-MM-DD purchase_pricenumber Original purchase price USD estimated_current_valuenumber Current estimated market value USD estimated_rental_valuenumber Estimated monthly rental value USD home_current_tax_liabilitynumber Annual property tax USD outstanding_loan_principalnumber Outstanding mortgage balance USD current_property_equity_amountnumber Estimated equity in property USD sqftnumber Square footage of property sq ft num_bedsnumber Number of bedrooms count num_bathsnumber Number of bathrooms count
Work Experience Array of employment history records ordered by recency. Each work experience object contains:
Position Identification Field Type Description experience_rankinteger Recency rank (1 = most recent / current position) minerva_experience_idstring Unique experience identifier
Field Type Description work_company_namestring Company name work_company_linkedin_urlstring Company’s LinkedIn page URL work_company_websitestring Company’s website URL work_company_industrystring Company’s industry classification
Industry Codes Field Type Description work_company_naics_codestring NAICS industry classification code work_company_naics_descriptionstring NAICS industry description work_company_sic_codestring SIC industry classification code work_company_sic_descriptionstring SIC industry description
Role Details Field Type Description Example Values work_titlestring Job title as listed "Senior Software Engineer"standard_work_titlestring Standardized/normalized job title "Software Engineer"work_seniority_levelstring Seniority level "Entry", "Senior", "Manager", "Executive"work_departmentstring Department within company "Engineering", "Sales", "Marketing"work_employment_typestring Type of employment "Full-Time", "Part-Time", "Contract"work_statusstring Current or past position "current", "previous"
Dates & Location Field Type Description work_start_datestring Employment start date (YYYY-MM-DD) work_end_datestring Employment end date (null if current) work_citystring Work location city work_statestring Work location state work_countrystring Work location country code
Education Experience Array of education records ordered by recency. Each education object contains:
Field Type Description Example Values experience_rankinteger Recency rank (1 = most recent) 1, 2minerva_experience_idstring Unique experience identifier "e-a1b2c3..."institution_namestring School/university name "Stanford University"institution_linkedin_urlstring Institution’s LinkedIn page URL education_informationstring Additional education details "Bachelor of Science (B.S.), Computer Science"education_levelstring Degree level attained "High School", "Bachelors", "Masters", "PhD"education_majorsarray Array of major fields of study ["Computer Science", "Mathematics"]education_minorsarray Array of minor fields of study ["Business"]education_start_datestring Enrollment start date "2013-08-15"education_end_datestring Graduation/completion date "2017-05-31"
Notes
Empty Arrays All list fields (emails, phones, addresses, work, education, relatives) return empty arrays [] if no data is available.
Date Format All dates are returned in ISO 8601 format: YYYY-MM-DD
Currency All financial figures (property values, prices, etc.) are in USD.
Ranking Arrays are ordered by rank field, with rank=1 being the most recent or most reliable.
Using return_fields You can optimize your API response by specifying only the fields you need using the return_fields parameter. Base fields are always included.
Available return_fields options: 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, phones Using return_fields reduces response size and improves API latency. Request only the data you need!
