Enrich v1 - Minerva Documentation

Enrich v1

curl --request POST \
  --url https://api.minerva.io/v1/enrich \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "records": [
    {
      "record_id": "<string>",
      "first_name": "<string>",
      "middle_name": "<string>",
      "last_name": "<string>",
      "full_name": "<string>",
      "name_suffix": "<string>",
      "emails": [
        "<string>"
      ],
      "phones": [
        "<string>"
      ]
    }
  ]
}
'

{
  "api_request_id": "req_abc123xyz789",
  "request_completed_at": "2024-01-15T10:30:45.123456+00:00",
  "results": [
    {
      "record_id": "user_001",
      "is_match": true,
      "minerva_pid": "p-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "full_name": "JOHN M SMITH",
      "first_name": "JOHN",
      "middle_name": "M",
      "last_name": "SMITH",
      "name_suffix": null,
      "gender": "M",
      "dob": "1990-05-15",
      "age": 34,
      "marital_status": "M",
      "minerva_household_id": "h-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "minerva_spouse_pid": null,
      "number_of_children": 2,
      "is_retired": false,
      "estimated_income_range": "$101K - $250K",
      "estimated_wealth_range": "$1M-$2M",
      "home_ownership_status": null,
      "linkedin_url": "https://www.linkedin.com/in/johnsmith",
      "linkedin_title": "Senior Software Engineer | Technology Leader",
      "linkedin_industry": null,
      "is_likely_remote_worker": false,
      "facebook_url": null,
      "twitter_url": null,
      "has_bankruptcy_records": false,
      "has_judgment_records": false,
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@gmail.com"
        },
        {
          "email_rank": 2,
          "email_address": "jsmith@email.com"
        },
        {
          "email_rank": 3,
          "email_address": "johnsmith123@yahoo.com"
        }
      ],
      "professional_emails": [],
      "phones": [
        {
          "phone_rank": 1,
          "phone_type": "Mobile",
          "phone_number": "(555) 123-4567"
        },
        {
          "phone_rank": 2,
          "phone_type": "Mobile",
          "phone_number": "(555) 234-5678"
        },
        {
          "phone_rank": 3,
          "phone_type": "Landline/Services",
          "phone_number": "(555) 345-6789"
        }
      ],
      "address_history": [
        {
          "address_rank": 1,
          "minerva_address_id": "a-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "address_line_1": "123 MAIN ST",
          "address_line_2": null,
          "address_city": "SAN FRANCISCO",
          "address_state": "CA",
          "address_zipcode": "94102",
          "address_zipcode4": "1234",
          "ownership_status": "Unknown",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": null,
          "estimated_rental_value": null,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": null,
          "num_beds": null,
          "num_baths": null,
          "first_seen_date": "2023-01-15",
          "last_seen_date": "2024-01-15"
        },
        {
          "address_rank": 2,
          "minerva_address_id": "a-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "address_line_1": "456 OAK AVE",
          "address_line_2": null,
          "address_city": "PALO ALTO",
          "address_state": "CA",
          "address_zipcode": "94301",
          "address_zipcode4": "5678",
          "ownership_status": "Rented",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": 1020000.0,
          "estimated_rental_value": 6221.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2789.0,
          "num_beds": 4.0,
          "num_baths": 4.0,
          "first_seen_date": "2020-06-01",
          "last_seen_date": "2023-01-14"
        },
        {
          "address_rank": 3,
          "minerva_address_id": "a-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "address_line_1": "789 ELM ST",
          "address_line_2": null,
          "address_city": "MOUNTAIN VIEW",
          "address_state": "CA",
          "address_zipcode": "94040",
          "address_zipcode4": "9012",
          "ownership_status": "Owned",
          "is_current_owner": false,
          "purchase_date": "2015-03-20",
          "purchase_price": null,
          "estimated_current_value": 1493190.0,
          "estimated_rental_value": 7189.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2979.0,
          "num_beds": 4.0,
          "num_baths": 2.5,
          "first_seen_date": "2015-03-20",
          "last_seen_date": "2020-05-31"
        }
      ],
      "work_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "w-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "work_company_name": "Tech Solutions Inc",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-solutions",
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Senior Software Engineer",
          "standard_work_title": "Senior Software Engineer",
          "work_seniority_level": "Senior",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "current",
          "work_start_date": "2020-01-01",
          "work_end_date": null,
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 2,
          "minerva_experience_id": "w-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "work_company_name": "Startup Ventures",
          "work_company_linkedin_url": "https://www.linkedin.com/company/startup-ventures",
          "work_company_website": "https://startupventures.com",
          "work_company_industry": "Technology",
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Software Engineer",
          "standard_work_title": "Software Engineer",
          "work_seniority_level": "Mid",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2018-06-01",
          "work_end_date": "2019-12-31",
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 3,
          "minerva_experience_id": "w-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Junior Developer",
          "standard_work_title": "Junior Developer",
          "work_seniority_level": "Entry",
          "work_department": "Technology",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2016-08-01",
          "work_end_date": "2018-05-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 4,
          "minerva_experience_id": "w-d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Summer Analyst",
          "standard_work_title": "Summer Analyst",
          "work_seniority_level": "Intern",
          "work_department": "Technology",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2015-06-01",
          "work_end_date": "2015-08-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 5,
          "minerva_experience_id": "w-e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
          "work_company_name": "Tech Innovations",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-innovations",
          "work_company_website": "https://techinnovations.com",
          "work_company_industry": "Computer Software",
          "work_company_naics_code": "511210",
          "work_company_naics_description": "Software Publishers",
          "work_company_sic_code": "7372",
          "work_company_sic_description": "Prepackaged Software",
          "work_title": "Software Engineering Intern",
          "standard_work_title": "Software Engineering Intern",
          "work_seniority_level": "Intern",
          "work_department": "Engineering",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2014-06-01",
          "work_end_date": "2014-08-31",
          "work_city": "Seattle",
          "work_state": "WA",
          "work_country": "US"
        },
        {
          "experience_rank": 6,
          "minerva_experience_id": "w-f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
          "work_company_name": "Startup Labs",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Co-Founder",
          "standard_work_title": "Co-Founder",
          "work_seniority_level": "Executive",
          "work_department": "Executive",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2013-01-01",
          "work_end_date": "2013-12-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 7,
          "minerva_experience_id": "w-a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
          "work_company_name": "Research Institute",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Research Assistant",
          "standard_work_title": "Research Assistant",
          "work_seniority_level": "Entry",
          "work_department": "Research",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2012-09-01",
          "work_end_date": "2013-05-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 8,
          "minerva_experience_id": "w-b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
          "work_company_name": "Community Organization",
          "work_company_linkedin_url": "https://www.linkedin.com/company/community-org",
          "work_company_website": "https://communityorg.org",
          "work_company_industry": "Nonprofit",
          "work_company_naics_code": "813920",
          "work_company_naics_description": "Professional Organizations",
          "work_company_sic_code": "8621",
          "work_company_sic_description": "Professional organizations",
          "work_title": "Volunteer Coordinator",
          "standard_work_title": "Volunteer Coordinator",
          "work_seniority_level": "Entry",
          "work_department": "Operations",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2011-06-01",
          "work_end_date": "2011-11-30",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 9,
          "minerva_experience_id": "w-c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4",
          "work_company_name": "Consulting Group",
          "work_company_linkedin_url": "https://www.linkedin.com/company/consulting-group",
          "work_company_website": "https://consultinggroup.com",
          "work_company_industry": "Management Consulting",
          "work_company_naics_code": "541614",
          "work_company_naics_description": "Process, Physical Distribution, and Logistics Consulting Services",
          "work_company_sic_code": "8742",
          "work_company_sic_description": "Management consulting services",
          "work_title": "Summer Intern",
          "standard_work_title": "Summer Intern",
          "work_seniority_level": "Intern",
          "work_department": null,
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2010-06-01",
          "work_end_date": "2010-08-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        }
      ],
      "education_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "e-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "institution_name": "State University",
          "institution_linkedin_url": "https://www.linkedin.com/school/state-university",
          "education_information": "Bachelor of Science (B.S.), Computer Science",
          "education_level": "Bachelors",
          "education_majors": [
            "Computer Science",
            "Mathematics"
          ],
          "education_minors": [],
          "education_start_date": "2012-09-01",
          "education_end_date": "2016-05-31"
        }
      ],
      "match_score": 110.0,
      "validation_errors": null
    }
  ]
}

POST

enrich

Enrich v1

curl --request POST \
  --url https://api.minerva.io/v1/enrich \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "records": [
    {
      "record_id": "<string>",
      "first_name": "<string>",
      "middle_name": "<string>",
      "last_name": "<string>",
      "full_name": "<string>",
      "name_suffix": "<string>",
      "emails": [
        "<string>"
      ],
      "phones": [
        "<string>"
      ]
    }
  ]
}
'

{
  "api_request_id": "req_abc123xyz789",
  "request_completed_at": "2024-01-15T10:30:45.123456+00:00",
  "results": [
    {
      "record_id": "user_001",
      "is_match": true,
      "minerva_pid": "p-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "full_name": "JOHN M SMITH",
      "first_name": "JOHN",
      "middle_name": "M",
      "last_name": "SMITH",
      "name_suffix": null,
      "gender": "M",
      "dob": "1990-05-15",
      "age": 34,
      "marital_status": "M",
      "minerva_household_id": "h-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "minerva_spouse_pid": null,
      "number_of_children": 2,
      "is_retired": false,
      "estimated_income_range": "$101K - $250K",
      "estimated_wealth_range": "$1M-$2M",
      "home_ownership_status": null,
      "linkedin_url": "https://www.linkedin.com/in/johnsmith",
      "linkedin_title": "Senior Software Engineer | Technology Leader",
      "linkedin_industry": null,
      "is_likely_remote_worker": false,
      "facebook_url": null,
      "twitter_url": null,
      "has_bankruptcy_records": false,
      "has_judgment_records": false,
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@gmail.com"
        },
        {
          "email_rank": 2,
          "email_address": "jsmith@email.com"
        },
        {
          "email_rank": 3,
          "email_address": "johnsmith123@yahoo.com"
        }
      ],
      "professional_emails": [],
      "phones": [
        {
          "phone_rank": 1,
          "phone_type": "Mobile",
          "phone_number": "(555) 123-4567"
        },
        {
          "phone_rank": 2,
          "phone_type": "Mobile",
          "phone_number": "(555) 234-5678"
        },
        {
          "phone_rank": 3,
          "phone_type": "Landline/Services",
          "phone_number": "(555) 345-6789"
        }
      ],
      "address_history": [
        {
          "address_rank": 1,
          "minerva_address_id": "a-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "address_line_1": "123 MAIN ST",
          "address_line_2": null,
          "address_city": "SAN FRANCISCO",
          "address_state": "CA",
          "address_zipcode": "94102",
          "address_zipcode4": "1234",
          "ownership_status": "Unknown",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": null,
          "estimated_rental_value": null,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": null,
          "num_beds": null,
          "num_baths": null,
          "first_seen_date": "2023-01-15",
          "last_seen_date": "2024-01-15"
        },
        {
          "address_rank": 2,
          "minerva_address_id": "a-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "address_line_1": "456 OAK AVE",
          "address_line_2": null,
          "address_city": "PALO ALTO",
          "address_state": "CA",
          "address_zipcode": "94301",
          "address_zipcode4": "5678",
          "ownership_status": "Rented",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": 1020000.0,
          "estimated_rental_value": 6221.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2789.0,
          "num_beds": 4.0,
          "num_baths": 4.0,
          "first_seen_date": "2020-06-01",
          "last_seen_date": "2023-01-14"
        },
        {
          "address_rank": 3,
          "minerva_address_id": "a-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "address_line_1": "789 ELM ST",
          "address_line_2": null,
          "address_city": "MOUNTAIN VIEW",
          "address_state": "CA",
          "address_zipcode": "94040",
          "address_zipcode4": "9012",
          "ownership_status": "Owned",
          "is_current_owner": false,
          "purchase_date": "2015-03-20",
          "purchase_price": null,
          "estimated_current_value": 1493190.0,
          "estimated_rental_value": 7189.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2979.0,
          "num_beds": 4.0,
          "num_baths": 2.5,
          "first_seen_date": "2015-03-20",
          "last_seen_date": "2020-05-31"
        }
      ],
      "work_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "w-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "work_company_name": "Tech Solutions Inc",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-solutions",
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Senior Software Engineer",
          "standard_work_title": "Senior Software Engineer",
          "work_seniority_level": "Senior",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "current",
          "work_start_date": "2020-01-01",
          "work_end_date": null,
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 2,
          "minerva_experience_id": "w-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "work_company_name": "Startup Ventures",
          "work_company_linkedin_url": "https://www.linkedin.com/company/startup-ventures",
          "work_company_website": "https://startupventures.com",
          "work_company_industry": "Technology",
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Software Engineer",
          "standard_work_title": "Software Engineer",
          "work_seniority_level": "Mid",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2018-06-01",
          "work_end_date": "2019-12-31",
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 3,
          "minerva_experience_id": "w-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Junior Developer",
          "standard_work_title": "Junior Developer",
          "work_seniority_level": "Entry",
          "work_department": "Technology",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2016-08-01",
          "work_end_date": "2018-05-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 4,
          "minerva_experience_id": "w-d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Summer Analyst",
          "standard_work_title": "Summer Analyst",
          "work_seniority_level": "Intern",
          "work_department": "Technology",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2015-06-01",
          "work_end_date": "2015-08-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 5,
          "minerva_experience_id": "w-e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
          "work_company_name": "Tech Innovations",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-innovations",
          "work_company_website": "https://techinnovations.com",
          "work_company_industry": "Computer Software",
          "work_company_naics_code": "511210",
          "work_company_naics_description": "Software Publishers",
          "work_company_sic_code": "7372",
          "work_company_sic_description": "Prepackaged Software",
          "work_title": "Software Engineering Intern",
          "standard_work_title": "Software Engineering Intern",
          "work_seniority_level": "Intern",
          "work_department": "Engineering",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2014-06-01",
          "work_end_date": "2014-08-31",
          "work_city": "Seattle",
          "work_state": "WA",
          "work_country": "US"
        },
        {
          "experience_rank": 6,
          "minerva_experience_id": "w-f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
          "work_company_name": "Startup Labs",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Co-Founder",
          "standard_work_title": "Co-Founder",
          "work_seniority_level": "Executive",
          "work_department": "Executive",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2013-01-01",
          "work_end_date": "2013-12-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 7,
          "minerva_experience_id": "w-a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
          "work_company_name": "Research Institute",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Research Assistant",
          "standard_work_title": "Research Assistant",
          "work_seniority_level": "Entry",
          "work_department": "Research",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2012-09-01",
          "work_end_date": "2013-05-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 8,
          "minerva_experience_id": "w-b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
          "work_company_name": "Community Organization",
          "work_company_linkedin_url": "https://www.linkedin.com/company/community-org",
          "work_company_website": "https://communityorg.org",
          "work_company_industry": "Nonprofit",
          "work_company_naics_code": "813920",
          "work_company_naics_description": "Professional Organizations",
          "work_company_sic_code": "8621",
          "work_company_sic_description": "Professional organizations",
          "work_title": "Volunteer Coordinator",
          "standard_work_title": "Volunteer Coordinator",
          "work_seniority_level": "Entry",
          "work_department": "Operations",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2011-06-01",
          "work_end_date": "2011-11-30",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 9,
          "minerva_experience_id": "w-c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4",
          "work_company_name": "Consulting Group",
          "work_company_linkedin_url": "https://www.linkedin.com/company/consulting-group",
          "work_company_website": "https://consultinggroup.com",
          "work_company_industry": "Management Consulting",
          "work_company_naics_code": "541614",
          "work_company_naics_description": "Process, Physical Distribution, and Logistics Consulting Services",
          "work_company_sic_code": "8742",
          "work_company_sic_description": "Management consulting services",
          "work_title": "Summer Intern",
          "standard_work_title": "Summer Intern",
          "work_seniority_level": "Intern",
          "work_department": null,
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2010-06-01",
          "work_end_date": "2010-08-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        }
      ],
      "education_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "e-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "institution_name": "State University",
          "institution_linkedin_url": "https://www.linkedin.com/school/state-university",
          "education_information": "Bachelor of Science (B.S.), Computer Science",
          "education_level": "Bachelors",
          "education_majors": [
            "Computer Science",
            "Mathematics"
          ],
          "education_minors": [],
          "education_start_date": "2012-09-01",
          "education_end_date": "2016-05-31"
        }
      ],
      "match_score": 110.0,
      "validation_errors": null
    }
  ]
}

Overview

The Enrich endpoint combines resolution and data enrichment in a single call. It first resolves the person identity using fuzzy matching, then returns comprehensive profile data including demographics, work history, education, addresses, and contact information. Note: Consider upgrading to /v2/enrich for direct PID/LinkedIn lookups, selective field returns, and improved performance.

Request

Headers

x-api-key

string

required

Your API key for authentication

Content-Type

string

required

application/json

Request Body

records

object[]

required

An array of person records to enrich. Maximum 500 records per request.

Show Record object properties

record_id

string

required

Your unique identifier for this record

first_name

string

Person’s first name

middle_name

string

Person’s middle name

last_name

string

Person’s last name

full_name

string

Person’s full name

name_suffix

string

Name suffix (e.g., “Jr.”, “Sr.”, “III”)

emails

string[]

Array of email addresses

phones

string[]

Array of phone numbers

Request Example

{
  "records": [
    {
      "record_id": "user_001",
      "first_name": "John",
      "last_name": "Smith",
      "emails": ["john.smith@example.com"],
      "phones": ["+1-555-123-4567"]
    }
  ]
}

Response

Response Structure

api_request_id

string

Unique identifier for this API request

results

array

Array of enrichment results

request_completed_at

string

ISO 8601 timestamp when the request was completed

Result Object - Demographics

record_id

string

Your identifier from the request

is_match

boolean

Whether a match was found

minerva_pid

string

Minerva person identifier

full_name

string

Person’s full name

first_name

string

First name

middle_name

string

Middle name

last_name

string

Last name

name_suffix

string

Name suffix

gender

string

Gender (“M” for male, “F” for female, or null)

dob

string

Date of birth (ISO 8601 format)

age

integer

Current age

marital_status

string

Marital status (“M” for married, “S” for single, or null)

minerva_household_id

string

Household identifier

minerva_spouse_pid

string

Spouse’s Minerva PID if available

number_of_children

integer

Number of children

Result Object - Financial

is_retired

boolean

Whether the person is retired

estimated_income_range

string

Estimated income bracket

estimated_wealth_range

string

Estimated wealth bracket

home_ownership_status

string

Home ownership status (e.g., “Owner”, “Renter”, or null)

linkedin_url

string

LinkedIn profile URL

linkedin_title

string

Current title from LinkedIn

linkedin_industry

string

Industry from LinkedIn

is_likely_remote_worker

boolean

Whether the person likely works remotely

facebook_url

string

Facebook profile URL

twitter_url

string

Twitter profile URL

Result Object - Legal Records

has_bankruptcy_records

boolean

Whether bankruptcy records exist

has_judgment_records

boolean

Whether judgment records exist

Result Object - Contact Information

personal_emails

array

Array of personal email addresses with ranking

Show Email object properties

email_rank

integer

Rank/priority of this email (1 = highest priority)

email_address

string

Email address

professional_emails

array

Array of professional email addresses with ranking

Show Email object properties

email_rank

integer

Rank/priority of this email (1 = highest priority)

email_address

string

Email address

phones

array

Array of phone numbers with type and ranking

Show Phone object properties

phone_rank

integer

Rank/priority of this phone (1 = highest priority)

phone_type

string

Phone type (e.g., “Mobile”, “Landline”)

phone_number

string

Phone number

Result Object - Address History

address_history

array

Array of address records with property details

Show Address object properties

address_rank

integer

Rank of address (1 = most recent/current)

minerva_address_id

string

Unique address identifier

address_line_1

string

Street address

address_line_2

string

Apartment/unit number

address_city

string

City

address_state

string

State

address_zipcode

string

ZIP code

address_zipcode4

string

ZIP+4 extension

ownership_status

string

Ownership status (“Owned” / “Rented” / “Unknown”)

is_current_owner

boolean

Whether person currently owns this property (true / false / null)

purchase_date

string

Date property was purchased

purchase_price

number

Purchase price in USD

estimated_current_value

number

Current estimated value in USD

estimated_rental_value

number

Estimated monthly rental value in USD

home_current_tax_liability

number

Annual property tax in USD

outstanding_loan_principal

number

Outstanding mortgage balance in USD

current_property_equity_amount

number

Estimated equity in USD

sqft

number

Square footage

num_beds

number

Number of bedrooms

num_baths

number

Number of bathrooms

first_seen_date

string

First date person was associated with this address

last_seen_date

string

Last date person was associated with this address

Result Object - Work Experience

work_experience

array

Array of work history records

Show Work experience object properties

experience_rank

integer

Rank (1 = most recent)

minerva_experience_id

string

Unique experience identifier

work_company_name

string

Company name

work_company_linkedin_url

string

Company LinkedIn URL

work_company_website

string

Company website

work_company_industry

string

Company industry

work_company_naics_code

string

NAICS industry classification code

work_company_naics_description

string

NAICS industry description

work_company_sic_code

string

SIC industry code

work_company_sic_description

string

SIC industry description

work_title

string

Job title

standard_work_title

string

Standardized job title

work_seniority_level

string

Seniority level (e.g., “Senior”, “Manager”, “Executive”)

work_department

string

Department

work_employment_type

string

Employment type (e.g., “Full-time”, “Part-time”)

work_status

string

Employment status (“current” or “previous”)

work_start_date

string

Start date

work_end_date

string

End date (null if current)

work_city

string

Work location city

work_state

string

Work location state

work_country

string

Work location country

Result Object - Education

education_experience

array

Array of education records

Show Education object properties

experience_rank

integer

Rank (1 = most recent)

minerva_experience_id

string

Unique experience identifier

institution_name

string

School/university name

institution_linkedin_url

string

Institution LinkedIn URL

education_information

string

Additional education details

education_level

string

Degree level (e.g., “Bachelor’s”, “Master’s”, “PhD”)

education_majors

array

Array of major fields of study

education_minors

array

Array of minor fields of study

education_start_date

string

Start date

education_end_date

string

Graduation date

Result Object - Other Fields

match_score

number

Confidence score for the match (0-1 scale)

validation_errors

object

Any validation errors from the input

Error responses include statusCode and body fields for backward compatibility with existing integrations. These are deprecated — prefer reading the HTTP status code and the top-level api_request_id / error_message fields directly.

{
  "api_request_id": "req_abc123xyz789",
  "request_completed_at": "2024-01-15T10:30:45.123456+00:00",
  "results": [
    {
      "record_id": "user_001",
      "is_match": true,
      "minerva_pid": "p-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "full_name": "JOHN M SMITH",
      "first_name": "JOHN",
      "middle_name": "M",
      "last_name": "SMITH",
      "name_suffix": null,
      "gender": "M",
      "dob": "1990-05-15",
      "age": 34,
      "marital_status": "M",
      "minerva_household_id": "h-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
      "minerva_spouse_pid": null,
      "number_of_children": 2,
      "is_retired": false,
      "estimated_income_range": "$101K - $250K",
      "estimated_wealth_range": "$1M-$2M",
      "home_ownership_status": null,
      "linkedin_url": "https://www.linkedin.com/in/johnsmith",
      "linkedin_title": "Senior Software Engineer | Technology Leader",
      "linkedin_industry": null,
      "is_likely_remote_worker": false,
      "facebook_url": null,
      "twitter_url": null,
      "has_bankruptcy_records": false,
      "has_judgment_records": false,
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@gmail.com"
        },
        {
          "email_rank": 2,
          "email_address": "jsmith@email.com"
        },
        {
          "email_rank": 3,
          "email_address": "johnsmith123@yahoo.com"
        }
      ],
      "professional_emails": [],
      "phones": [
        {
          "phone_rank": 1,
          "phone_type": "Mobile",
          "phone_number": "(555) 123-4567"
        },
        {
          "phone_rank": 2,
          "phone_type": "Mobile",
          "phone_number": "(555) 234-5678"
        },
        {
          "phone_rank": 3,
          "phone_type": "Landline/Services",
          "phone_number": "(555) 345-6789"
        }
      ],
      "address_history": [
        {
          "address_rank": 1,
          "minerva_address_id": "a-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "address_line_1": "123 MAIN ST",
          "address_line_2": null,
          "address_city": "SAN FRANCISCO",
          "address_state": "CA",
          "address_zipcode": "94102",
          "address_zipcode4": "1234",
          "ownership_status": "Unknown",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": null,
          "estimated_rental_value": null,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": null,
          "num_beds": null,
          "num_baths": null,
          "first_seen_date": "2023-01-15",
          "last_seen_date": "2024-01-15"
        },
        {
          "address_rank": 2,
          "minerva_address_id": "a-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "address_line_1": "456 OAK AVE",
          "address_line_2": null,
          "address_city": "PALO ALTO",
          "address_state": "CA",
          "address_zipcode": "94301",
          "address_zipcode4": "5678",
          "ownership_status": "Rented",
          "is_current_owner": null,
          "purchase_date": null,
          "purchase_price": null,
          "estimated_current_value": 1020000.0,
          "estimated_rental_value": 6221.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2789.0,
          "num_beds": 4.0,
          "num_baths": 4.0,
          "first_seen_date": "2020-06-01",
          "last_seen_date": "2023-01-14"
        },
        {
          "address_rank": 3,
          "minerva_address_id": "a-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "address_line_1": "789 ELM ST",
          "address_line_2": null,
          "address_city": "MOUNTAIN VIEW",
          "address_state": "CA",
          "address_zipcode": "94040",
          "address_zipcode4": "9012",
          "ownership_status": "Owned",
          "is_current_owner": false,
          "purchase_date": "2015-03-20",
          "purchase_price": null,
          "estimated_current_value": 1493190.0,
          "estimated_rental_value": 7189.0,
          "home_current_tax_liability": null,
          "outstanding_loan_principal": null,
          "current_property_equity_amount": null,
          "sqft": 2979.0,
          "num_beds": 4.0,
          "num_baths": 2.5,
          "first_seen_date": "2015-03-20",
          "last_seen_date": "2020-05-31"
        }
      ],
      "work_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "w-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "work_company_name": "Tech Solutions Inc",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-solutions",
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Senior Software Engineer",
          "standard_work_title": "Senior Software Engineer",
          "work_seniority_level": "Senior",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "current",
          "work_start_date": "2020-01-01",
          "work_end_date": null,
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 2,
          "minerva_experience_id": "w-b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
          "work_company_name": "Startup Ventures",
          "work_company_linkedin_url": "https://www.linkedin.com/company/startup-ventures",
          "work_company_website": "https://startupventures.com",
          "work_company_industry": "Technology",
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Software Engineer",
          "standard_work_title": "Software Engineer",
          "work_seniority_level": "Mid",
          "work_department": "Engineering",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2018-06-01",
          "work_end_date": "2019-12-31",
          "work_city": "San Francisco",
          "work_state": "CA",
          "work_country": "US"
        },
        {
          "experience_rank": 3,
          "minerva_experience_id": "w-c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Junior Developer",
          "standard_work_title": "Junior Developer",
          "work_seniority_level": "Entry",
          "work_department": "Technology",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2016-08-01",
          "work_end_date": "2018-05-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 4,
          "minerva_experience_id": "w-d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
          "work_company_name": "Financial Corp",
          "work_company_linkedin_url": "https://www.linkedin.com/company/financial-corp",
          "work_company_website": "https://financialcorp.com",
          "work_company_industry": "Financial Services",
          "work_company_naics_code": "523930",
          "work_company_naics_description": "Investment Advice",
          "work_company_sic_code": "6282",
          "work_company_sic_description": "Investment Advice",
          "work_title": "Summer Analyst",
          "standard_work_title": "Summer Analyst",
          "work_seniority_level": "Intern",
          "work_department": "Technology",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2015-06-01",
          "work_end_date": "2015-08-31",
          "work_city": "New York",
          "work_state": "NY",
          "work_country": "US"
        },
        {
          "experience_rank": 5,
          "minerva_experience_id": "w-e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
          "work_company_name": "Tech Innovations",
          "work_company_linkedin_url": "https://www.linkedin.com/company/tech-innovations",
          "work_company_website": "https://techinnovations.com",
          "work_company_industry": "Computer Software",
          "work_company_naics_code": "511210",
          "work_company_naics_description": "Software Publishers",
          "work_company_sic_code": "7372",
          "work_company_sic_description": "Prepackaged Software",
          "work_title": "Software Engineering Intern",
          "standard_work_title": "Software Engineering Intern",
          "work_seniority_level": "Intern",
          "work_department": "Engineering",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2014-06-01",
          "work_end_date": "2014-08-31",
          "work_city": "Seattle",
          "work_state": "WA",
          "work_country": "US"
        },
        {
          "experience_rank": 6,
          "minerva_experience_id": "w-f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
          "work_company_name": "Startup Labs",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Co-Founder",
          "standard_work_title": "Co-Founder",
          "work_seniority_level": "Executive",
          "work_department": "Executive",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2013-01-01",
          "work_end_date": "2013-12-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 7,
          "minerva_experience_id": "w-a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
          "work_company_name": "Research Institute",
          "work_company_linkedin_url": null,
          "work_company_website": null,
          "work_company_industry": null,
          "work_company_naics_code": null,
          "work_company_naics_description": null,
          "work_company_sic_code": null,
          "work_company_sic_description": null,
          "work_title": "Research Assistant",
          "standard_work_title": "Research Assistant",
          "work_seniority_level": "Entry",
          "work_department": "Research",
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2012-09-01",
          "work_end_date": "2013-05-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 8,
          "minerva_experience_id": "w-b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
          "work_company_name": "Community Organization",
          "work_company_linkedin_url": "https://www.linkedin.com/company/community-org",
          "work_company_website": "https://communityorg.org",
          "work_company_industry": "Nonprofit",
          "work_company_naics_code": "813920",
          "work_company_naics_description": "Professional Organizations",
          "work_company_sic_code": "8621",
          "work_company_sic_description": "Professional organizations",
          "work_title": "Volunteer Coordinator",
          "standard_work_title": "Volunteer Coordinator",
          "work_seniority_level": "Entry",
          "work_department": "Operations",
          "work_employment_type": "Full-Time",
          "work_status": "previous",
          "work_start_date": "2011-06-01",
          "work_end_date": "2011-11-30",
          "work_city": null,
          "work_state": null,
          "work_country": null
        },
        {
          "experience_rank": 9,
          "minerva_experience_id": "w-c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4",
          "work_company_name": "Consulting Group",
          "work_company_linkedin_url": "https://www.linkedin.com/company/consulting-group",
          "work_company_website": "https://consultinggroup.com",
          "work_company_industry": "Management Consulting",
          "work_company_naics_code": "541614",
          "work_company_naics_description": "Process, Physical Distribution, and Logistics Consulting Services",
          "work_company_sic_code": "8742",
          "work_company_sic_description": "Management consulting services",
          "work_title": "Summer Intern",
          "standard_work_title": "Summer Intern",
          "work_seniority_level": "Intern",
          "work_department": null,
          "work_employment_type": "Part-Time",
          "work_status": "previous",
          "work_start_date": "2010-06-01",
          "work_end_date": "2010-08-31",
          "work_city": null,
          "work_state": null,
          "work_country": null
        }
      ],
      "education_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "e-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
          "institution_name": "State University",
          "institution_linkedin_url": "https://www.linkedin.com/school/state-university",
          "education_information": "Bachelor of Science (B.S.), Computer Science",
          "education_level": "Bachelors",
          "education_majors": [
            "Computer Science",
            "Mathematics"
          ],
          "education_minors": [],
          "education_start_date": "2012-09-01",
          "education_end_date": "2016-05-31"
        }
      ],
      "match_score": 110.0,
      "validation_errors": null
    }
  ]
}

Error Responses

400 - Bad Request: Missing required fields or malformed JSON
401 - Unauthorized: Invalid or missing API key
402 - Payment Required: Minerva credits exhausted. Response body includes records_remaining (estimated records remaining based on your credit balance) and records_requested (batch size that was rejected)
413 - Payload Too Large: More than 500 records in request
422 - Unprocessable Entity: Validation errors in record data (invalid field names, data types, or values)
429 - Too Many Requests: Rate limit exceeded
500 - Internal Server Error: Unexpected server error

Notes

Maximum 500 records per request (lower than /resolve due to data volume)
All list fields (emails, phones, addresses, work, education) return empty arrays [] if no data is available
Dates are returned in ISO 8601 format (YYYY-MM-DD)
Financial figures are in USD
Arrays are ordered by rank, with rank=1 being the most recent/relevant

Enrich v2 Get LinkedIn Contact Info

⌘I

​Quick Answer

​Overview

​Request

​Headers

​Request Body

​Request Example

​Response

​Response Structure

​Result Object - Demographics

​Result Object - Financial

​Result Object - Social & Professional

​Result Object - Legal Records

​Result Object - Contact Information

​Result Object - Address History

​Result Object - Work Experience

​Result Object - Education

​Result Object - Other Fields

​Error Responses

​Notes

Quick Answer

Overview

Request

Headers

Request Body

Request Example

Response

Response Structure

Result Object - Demographics

Result Object - Financial

Result Object - Social & Professional

Result Object - Legal Records

Result Object - Contact Information

Result Object - Address History

Result Object - Work Experience

Result Object - Education

Result Object - Other Fields

Error Responses

Notes