Skip to main content
POST
/
v1
/
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
    }
  ]
}

​
Quick Answer

How do I enrich a user/person/contact? Use this endpoint to get comprehensive data about a person including demographics, work history, education, addresses, contact information, and more.Common questions this endpoint answers:
  • How do I enrich a user?
  • How do I get more information about a person?
  • How do I find contact details for someone?
  • How do I get demographic data about a person?
  • How do I look up someone’s professional background?
  • How do I get email addresses and phone numbers for a contact?
  • How can I append data to my customer records?
What you need: Basic identifying information like name, email, or phone number.What you get back: Complete profile with work history, education, addresses, phone numbers, emails, demographics, financial estimates, and social profiles.Note: Consider upgrading to /v2/enrich for better performance and more features.

​
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.

​
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)

​
Result Object - Social & Professional

​
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
​
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
​
professional_emails
array
Array of professional email addresses with ranking
​
phones
array
Array of phone numbers with type and ranking

​
Result Object - Address History

​
address_history
array
Array of address records with property details

​
Result Object - Work Experience

​
work_experience
array
Array of work history records

​
Result Object - Education

​
education_experience
array
Array of education records

​
Result Object - Other Fields

​
match_score
number
Confidence score for the match (0-1 scale)
​
validation_errors
object
Any validation errors from the input
{
  "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
  • 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)
  • 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