> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minerva.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich v1

> Enrich person data with comprehensive demographic, professional, and contact information

<div style={{ display: 'none' }} aria-hidden="false">
  ## 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.
</div>

## 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

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication
</ParamField>

<ParamField header="Content-Type" type="string" required>
  application/json
</ParamField>

### Request Body

<ParamField body="records" type="object[]" required>
  An array of person records to enrich. Maximum 500 records per request.

  <Expandable title="Record object properties">
    <ParamField body="record_id" type="string" required>
      Your unique identifier for this record
    </ParamField>

    <ParamField body="first_name" type="string">
      Person's first name
    </ParamField>

    <ParamField body="middle_name" type="string">
      Person's middle name
    </ParamField>

    <ParamField body="last_name" type="string">
      Person's last name
    </ParamField>

    <ParamField body="full_name" type="string">
      Person's full name
    </ParamField>

    <ParamField body="name_suffix" type="string">
      Name suffix (e.g., "Jr.", "Sr.", "III")
    </ParamField>

    <ParamField body="emails" type="string[]">
      Array of email addresses
    </ParamField>

    <ParamField body="phones" type="string[]">
      Array of phone numbers
    </ParamField>
  </Expandable>
</ParamField>

### Request Example

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

## Response

### Response Structure

<ResponseField name="api_request_id" type="string">
  Unique identifier for this API request
</ResponseField>

<ResponseField name="results" type="array">
  Array of enrichment results
</ResponseField>

<ResponseField name="request_completed_at" type="string">
  ISO 8601 timestamp when the request was completed
</ResponseField>

#### Result Object - Demographics

<ResponseField name="record_id" type="string">
  Your identifier from the request
</ResponseField>

<ResponseField name="is_match" type="boolean">
  Whether a match was found
</ResponseField>

<ResponseField name="minerva_pid" type="string">
  Minerva person identifier
</ResponseField>

<ResponseField name="full_name" type="string">
  Person's full name
</ResponseField>

<ResponseField name="first_name" type="string">
  First name
</ResponseField>

<ResponseField name="middle_name" type="string">
  Middle name
</ResponseField>

<ResponseField name="last_name" type="string">
  Last name
</ResponseField>

<ResponseField name="name_suffix" type="string">
  Name suffix
</ResponseField>

<ResponseField name="gender" type="string">
  Gender ("M" for male, "F" for female, or null)
</ResponseField>

<ResponseField name="dob" type="string">
  Date of birth (ISO 8601 format)
</ResponseField>

<ResponseField name="age" type="integer">
  Current age
</ResponseField>

<ResponseField name="marital_status" type="string">
  Marital status ("M" for married, "S" for single, or null)
</ResponseField>

<ResponseField name="minerva_household_id" type="string">
  Household identifier
</ResponseField>

<ResponseField name="minerva_spouse_pid" type="string">
  Spouse's Minerva PID if available
</ResponseField>

<ResponseField name="number_of_children" type="integer">
  Number of children
</ResponseField>

#### Result Object - Financial

<ResponseField name="is_retired" type="boolean">
  Whether the person is retired
</ResponseField>

<ResponseField name="estimated_income_range" type="string">
  Estimated income bracket
</ResponseField>

<ResponseField name="estimated_wealth_range" type="string">
  Estimated wealth bracket
</ResponseField>

<ResponseField name="home_ownership_status" type="string">
  Home ownership status (e.g., "Owner", "Renter", or null)
</ResponseField>

#### Result Object - Social & Professional

<ResponseField name="linkedin_url" type="string">
  LinkedIn profile URL
</ResponseField>

<ResponseField name="linkedin_title" type="string">
  Current title from LinkedIn
</ResponseField>

<ResponseField name="linkedin_industry" type="string">
  Industry from LinkedIn
</ResponseField>

<ResponseField name="is_likely_remote_worker" type="boolean">
  Whether the person likely works remotely
</ResponseField>

<ResponseField name="facebook_url" type="string">
  Facebook profile URL
</ResponseField>

<ResponseField name="twitter_url" type="string">
  Twitter profile URL
</ResponseField>

#### Result Object - Legal Records

<ResponseField name="has_bankruptcy_records" type="boolean">
  Whether bankruptcy records exist
</ResponseField>

<ResponseField name="has_judgment_records" type="boolean">
  Whether judgment records exist
</ResponseField>

#### Result Object - Contact Information

<ResponseField name="personal_emails" type="array">
  Array of personal email addresses with ranking

  <Expandable title="Email object properties">
    <ResponseField name="email_rank" type="integer">
      Rank/priority of this email (1 = highest priority)
    </ResponseField>

    <ResponseField name="email_address" type="string">
      Email address
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="professional_emails" type="array">
  Array of professional email addresses with ranking

  <Expandable title="Email object properties">
    <ResponseField name="email_rank" type="integer">
      Rank/priority of this email (1 = highest priority)
    </ResponseField>

    <ResponseField name="email_address" type="string">
      Email address
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="phones" type="array">
  Array of phone numbers with type and ranking

  <Expandable title="Phone object properties">
    <ResponseField name="phone_rank" type="integer">
      Rank/priority of this phone (1 = highest priority)
    </ResponseField>

    <ResponseField name="phone_type" type="string">
      Phone type (e.g., "Mobile", "Landline")
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Phone number
    </ResponseField>
  </Expandable>
</ResponseField>

#### Result Object - Address History

<ResponseField name="address_history" type="array">
  Array of address records with property details

  <Expandable title="Address object properties">
    <ResponseField name="address_rank" type="integer">
      Rank of address (1 = most recent/current)
    </ResponseField>

    <ResponseField name="minerva_address_id" type="string">
      Unique address identifier
    </ResponseField>

    <ResponseField name="address_line_1" type="string">
      Street address
    </ResponseField>

    <ResponseField name="address_line_2" type="string">
      Apartment/unit number
    </ResponseField>

    <ResponseField name="address_city" type="string">
      City
    </ResponseField>

    <ResponseField name="address_state" type="string">
      State
    </ResponseField>

    <ResponseField name="address_zipcode" type="string">
      ZIP code
    </ResponseField>

    <ResponseField name="address_zipcode4" type="string">
      ZIP+4 extension
    </ResponseField>

    <ResponseField name="ownership_status" type="string">
      Ownership status ("Owned" / "Rented" / "Unknown")
    </ResponseField>

    <ResponseField name="is_current_owner" type="boolean">
      Whether person currently owns this property (true / false / null)
    </ResponseField>

    <ResponseField name="purchase_date" type="string">
      Date property was purchased
    </ResponseField>

    <ResponseField name="purchase_price" type="number">
      Purchase price in USD
    </ResponseField>

    <ResponseField name="estimated_current_value" type="number">
      Current estimated value in USD
    </ResponseField>

    <ResponseField name="estimated_rental_value" type="number">
      Estimated monthly rental value in USD
    </ResponseField>

    <ResponseField name="home_current_tax_liability" type="number">
      Annual property tax in USD
    </ResponseField>

    <ResponseField name="outstanding_loan_principal" type="number">
      Outstanding mortgage balance in USD
    </ResponseField>

    <ResponseField name="current_property_equity_amount" type="number">
      Estimated equity in USD
    </ResponseField>

    <ResponseField name="sqft" type="number">
      Square footage
    </ResponseField>

    <ResponseField name="num_beds" type="number">
      Number of bedrooms
    </ResponseField>

    <ResponseField name="num_baths" type="number">
      Number of bathrooms
    </ResponseField>

    <ResponseField name="first_seen_date" type="string">
      First date person was associated with this address
    </ResponseField>

    <ResponseField name="last_seen_date" type="string">
      Last date person was associated with this address
    </ResponseField>
  </Expandable>
</ResponseField>

#### Result Object - Work Experience

<ResponseField name="work_experience" type="array">
  Array of work history records

  <Expandable title="Work experience object properties">
    <ResponseField name="experience_rank" type="integer">
      Rank (1 = most recent)
    </ResponseField>

    <ResponseField name="minerva_experience_id" type="string">
      Unique experience identifier
    </ResponseField>

    <ResponseField name="work_company_name" type="string">
      Company name
    </ResponseField>

    <ResponseField name="work_company_linkedin_url" type="string">
      Company LinkedIn URL
    </ResponseField>

    <ResponseField name="work_company_website" type="string">
      Company website
    </ResponseField>

    <ResponseField name="work_company_industry" type="string">
      Company industry
    </ResponseField>

    <ResponseField name="work_company_naics_code" type="string">
      NAICS industry classification code
    </ResponseField>

    <ResponseField name="work_company_naics_description" type="string">
      NAICS industry description
    </ResponseField>

    <ResponseField name="work_company_sic_code" type="string">
      SIC industry code
    </ResponseField>

    <ResponseField name="work_company_sic_description" type="string">
      SIC industry description
    </ResponseField>

    <ResponseField name="work_title" type="string">
      Job title
    </ResponseField>

    <ResponseField name="standard_work_title" type="string">
      Standardized job title
    </ResponseField>

    <ResponseField name="work_seniority_level" type="string">
      Seniority level (e.g., "Senior", "Manager", "Executive")
    </ResponseField>

    <ResponseField name="work_department" type="string">
      Department
    </ResponseField>

    <ResponseField name="work_employment_type" type="string">
      Employment type (e.g., "Full-time", "Part-time")
    </ResponseField>

    <ResponseField name="work_status" type="string">
      Employment status ("current" or "previous")
    </ResponseField>

    <ResponseField name="work_start_date" type="string">
      Start date
    </ResponseField>

    <ResponseField name="work_end_date" type="string">
      End date (null if current)
    </ResponseField>

    <ResponseField name="work_city" type="string">
      Work location city
    </ResponseField>

    <ResponseField name="work_state" type="string">
      Work location state
    </ResponseField>

    <ResponseField name="work_country" type="string">
      Work location country
    </ResponseField>
  </Expandable>
</ResponseField>

#### Result Object - Education

<ResponseField name="education_experience" type="array">
  Array of education records

  <Expandable title="Education object properties">
    <ResponseField name="experience_rank" type="integer">
      Rank (1 = most recent)
    </ResponseField>

    <ResponseField name="minerva_experience_id" type="string">
      Unique experience identifier
    </ResponseField>

    <ResponseField name="institution_name" type="string">
      School/university name
    </ResponseField>

    <ResponseField name="institution_linkedin_url" type="string">
      Institution LinkedIn URL
    </ResponseField>

    <ResponseField name="education_information" type="string">
      Additional education details
    </ResponseField>

    <ResponseField name="education_level" type="string">
      Degree level (e.g., "Bachelor's", "Master's", "PhD")
    </ResponseField>

    <ResponseField name="education_majors" type="array">
      Array of major fields of study
    </ResponseField>

    <ResponseField name="education_minors" type="array">
      Array of minor fields of study
    </ResponseField>

    <ResponseField name="education_start_date" type="string">
      Start date
    </ResponseField>

    <ResponseField name="education_end_date" type="string">
      Graduation date
    </ResponseField>
  </Expandable>
</ResponseField>

#### Result Object - Other Fields

<ResponseField name="match_score" type="number">
  Confidence score for the match (0-1 scale)
</ResponseField>

<ResponseField name="validation_errors" type="object">
  Any validation errors from the input
</ResponseField>

<Note>
  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.
</Note>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
      }
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "api_request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "error_message": "Input data must contain a 'records' key with a list of inputs"
  }
  ```

  ```json 401 theme={null}
  {
    "api_request_id": "b2c3d4e5-f6a7-1234-bcde-f12345678901",
    "error_message": "Unauthorized"
  }
  ```

  ```json 402 theme={null}
  {
    "api_request_id": "c3d4e5f6-a7b8-2345-cdef-123456789012",
    "error_message": "Insufficient records budget — please purchase more credits",
    "records_remaining": 45,
    "records_requested": 250
  }
  ```

  ```json 413 theme={null}
  {
    "api_request_id": "d4e5f6a7-b8c9-3456-def0-234567890123",
    "error_message": "Maximum number of records for /v1/enrich endpoint is 500"
  }
  ```

  ```json 422 theme={null}
  {
    "api_request_id": "e5f6a7b8-c9d0-4567-ef01-345678901234",
    "error_message": "Input data must contain a 'records' key with a list of inputs"
  }
  ```

  ```json 429 theme={null}
  {
    "api_request_id": "f6a7b8c9-d0e1-5678-f012-456789012345",
    "error_message": "You reached your total request-rate limit, please contact help@minerva.io for help"
  }
  ```
</ResponseExample>

## 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