Enrichment

Batch enrich data

post

Enrich a batch of records. Each record must include:

• record_id (your unique identifier to track results)
• first_name
• last_name
• phones (array of strings)
• emails (array of strings)

At least one phone or email is required.

Though we return results in the order requested, we recommend using your record_id to correlate with your original inputs.

Authorizations

OAuthStaticTokenAuth

Header parameters

AuthorizationanyOptional

Bearer (OAuth) token containing the previously obtained minerva_api_oauth_token.

x-api-keyanyOptional

API Key (x-api-key) Use your static API key in the x-api-key header.

Content-TypestringRequiredExample: application/json

Body

Responses

200

Enrichment results

application/json

400

Bad request (missing fields, invalid JSON, etc.)

401

Unauthorized (invalid or missing token)

post

cURL-OAuthcURL-Static-TokenPython-OauthPython-Static-Token

curl -i -X POST \
  https://api.minerva.io/v1/enrich \
  -H "Authorization: Bearer <REPLACE_WITH_ID_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "record_id": "03c59496-7d74-4b77-bb5d-c6c9325435fb",
        "first_name": "Mathew",
        "last_name": "Joseph",
        "phones": ["[phone]"],
        "emails": ["[e-mail]"]
      },
      {
        "record_id": "05998f8f-73e8-4aec-b267-916b41b806d3",
        "first_name": "Alexander",
        "last_name": "Wilde",
        "phones": ["[phone]"],
        "emails": ["[e-mail]"]
      }
    ]
  }'

{
  "api_request_id": "abcd1234-5678-xyz",
  "results": [
    {
      "record_id": "11111111-1111-1111-1111-111111111111",
      "is_match": true,
      "minerva_pid": "p-000abc123",
      "full_name": "JOHN M SAMPLE",
      "first_name": "JOHN",
      "middle_name": "M",
      "last_name": "SAMPLE",
      "name_suffix": "JR",
      "gender": "M",
      "dob": "1985-01-01",
      "age": 38,
      "marital_status": "S",
      "minerva_household_id": "h-111xyz",
      "minerva_spouse_pid": "23498234-2349",
      "number_of_children": 0,
      "is_retired": false,
      "estimated_income_range": "$50K - $100K",
      "estimated_wealth_range": "$500K-$1M",
      "home_ownership_status": "Renter",
      "linkedin_url": "https://www.linkedin.com/in/john-sample",
      "linkedin_title": "Engineer",
      "linkedin_industry": "Placeholder Industry",
      "is_likely_remote_worker": false,
      "facebook_url": "facebook.com/mathewtjoseph",
      "twitter_url": "x.com/mj",
      "has_bankruptcy_records": false,
      "has_judgment_records": false,
      "address_history": [
        {
          "address_rank": 1,
          "minerva_address_id": "a-000xyz",
          "address_line_1": "123 Example St",
          "address_line_2": "Apt 2",
          "address_city": "Sample City",
          "address_state": "AA",
          "address_zipcode": "00000",
          "address_zipcode4": "1234",
          "ownership_status": "Rented",
          "is_current_owner": true,
          "purchase_date": "2015-01-01",
          "purchase_price": 1000000,
          "estimated_current_value": 500000,
          "estimated_rental_value": 500,
          "home_current_tax_liability": 10000,
          "outstanding_loan_principal": 100000,
          "current_property_equity_amount": 500,
          "sqft": 2350,
          "num_beds": 2,
          "num_baths": 1,
          "first_seen_date": "2010-01-01",
          "last_seen_date": "2020-12-31"
        }
      ],
      "education_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "e-900fab2703639dd860b143fd24ca1737",
          "institution_name": "University of California, Berkeley",
          "institution_linkedin_url": "https://www.linkedin.com/school/uc-berkeley",
          "education_information": "Bachelor of Arts (B.A.), Economics",
          "education_level": "Bachelors",
          "education_majors": [
            "Arts",
            "Economics"
          ],
          "education_minors": [],
          "education_start_date": "2013-08-15",
          "education_end_date": "2017-05-31"
        }
      ],
      "work_experience": [
        {
          "experience_rank": 1,
          "minerva_experience_id": "w-144c54582d2363c28ba7af352d04412d",
          "work_company_name": "Stealth",
          "work_company_linkedin_url": "https://www.linkedin.com/company/warmstealth",
          "work_company_website": "https://warmstealth.xyz",
          "work_company_industry": "Software Development",
          "work_company_naics_code": "561990",
          "work_company_naics_description": "All Other Support Services",
          "work_company_sic_code": "8699",
          "work_company_sic_description": "Membership organizations, nec",
          "work_title": "Co-Founder",
          "standard_work_title": "Co-Founder",
          "work_seniority_level": "Executive",
          "work_department": "Executive",
          "work_employment_type": "Full-Time",
          "work_status": "current",
          "work_start_date": "2023-05-01",
          "work_end_date": "2023-06-01",
          "work_city": "New York City",
          "work_state": "NY",
          "work_country": "US"
        }
      ],
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "[e-mail]"
        }
      ],
      "professional_emails": [
        {
          "email_rank": 1,
          "email_address": "[e-mail]"
        }
      ],
      "phones": [
        {
          "phone_rank": 1,
          "phone_type": "Mobile",
          "phone_number": "[phone]"
        }
      ],
      "match_score": 88.5,
      "validation_errors": ""
    }
  ],
  "request_completed_at": "2025-01-13T12:34:56Z"
}