# Minerva Documentation

## Docs

- [Data Dictionary](https://docs.minerva.io/api-reference/data-dictionary.md): Complete reference of all fields returned by the Minerva Enrich v2 API
- [Enrich v1](https://docs.minerva.io/api-reference/enrich.md): Enrich person data with comprehensive demographic, professional, and contact information
- [Enrich v2](https://docs.minerva.io/api-reference/enrich-v2.md): Enhanced enrichment with direct lookups, flexible matching, and selective field returns
- [Get LinkedIn Contact Info](https://docs.minerva.io/api-reference/get-li-contact-info.md): Retrieve contact information for LinkedIn profiles
- [Infer Record Country](https://docs.minerva.io/api-reference/infer-record-country.md): Infer country location from email addresses and phone numbers
- [Introduction](https://docs.minerva.io/api-reference/introduction.md): Minerva API Documentation
- [Person Search](https://docs.minerva.io/api-reference/person-search.md): Find people using a natural-language audience description and return matching Minerva PIDs with contact-channel coverage stats
- [Get Person Search](https://docs.minerva.io/api-reference/person-search-get.md): Retrieve a previously created person search by id, returning the same payload as the original search
- [Person Search Usage](https://docs.minerva.io/api-reference/person-search-usage.md): Retrieve your organization's daily person-search delivery limits, current-day consumption, and recent per-day history
- [Resolve v1](https://docs.minerva.io/api-reference/resolve.md): Resolve person identity from name and contact information to a Minerva PID
- [Resolve v2](https://docs.minerva.io/api-reference/resolve-v2.md): Enhanced resolve with reverse lookup capabilities and match condition filters
- [Segments - Create](https://docs.minerva.io/api-reference/segments-create.md): Create a named segment to organize and track cohorts of people for analysis and signal monitoring
- [Segments - Members](https://docs.minerva.io/api-reference/segments-members.md): Retrieve all members of a segment with pagination support
- [Segments - Add Members](https://docs.minerva.io/api-reference/segments-members-add.md): Add one or more people to an existing segment using their Minerva PIDs
- [Segments - Remove Members](https://docs.minerva.io/api-reference/segments-members-remove.md): Remove one or more people from an existing segment using their Minerva PIDs
- [Segments - Death Signals](https://docs.minerva.io/api-reference/segments-signals-deaths.md): Retrieve death records and obituary information for segment members who have deceased
- [Endpoint Usage](https://docs.minerva.io/api-reference/usage-endpoints.md): Retrieve org-wide API usage metrics for the endpoints available to your organization
- [Validate Emails](https://docs.minerva.io/api-reference/validate-emails.md): Validate email addresses and check their presence in the Minerva database
- [Authentication](https://docs.minerva.io/sdk/authentication.md): One credential — your API key. Goes on every request as `x-api-key`.
- [Async + bulk batching](https://docs.minerva.io/sdk/guides/async-and-batching.md): Use `AsyncMinerva` for concurrent calls under one client, with `enrich_many` / `resolve_many` for arbitrarily-large record lists.
- [Custom & tailored endpoints](https://docs.minerva.io/sdk/guides/custom-endpoints.md): Escape hatch for client-specific endpoints — preview routes, partner integrations, anything not yet wrapped in a typed SDK method.
- [Enrich](https://docs.minerva.io/sdk/guides/enrich.md): Full person profiles — identity, contact, professional, financial, household, relatives — from a record stub.
- [Error handling](https://docs.minerva.io/sdk/guides/error-handling.md): One exception hierarchy. Specific subclasses where you'd actually want to branch on the failure.
- [Liveness](https://docs.minerva.io/sdk/guides/health.md): Probe Minerva API endpoints via `mc.status.health()`. Auto-upgrades to an authenticated metrics view when the client has an API key. Never raises — safe to call in a polling loop.
- [Country inference](https://docs.minerva.io/sdk/guides/infer-country.md): Infer each record's country from its contact info (phone country code, email TLD, address signals, etc.).
- [LinkedIn contact info](https://docs.minerva.io/sdk/guides/linkedin.md): Look up ranked contact info for LinkedIn member IDs.
- [Output formats](https://docs.minerva.io/sdk/guides/output-formats.md): Every list-shaped result → dicts, DataFrame, CSV, or a pretty terminal table.
- [Person Search](https://docs.minerva.io/sdk/guides/person-search.md): Find people from a natural-language audience description. Returns matching Minerva PIDs plus contact-channel coverage stats.
- [Rate limiting (built in)](https://docs.minerva.io/sdk/guides/rate-limiting.md): The SDK self-throttles to your plan's rate so you can fan out concurrent calls without writing your own throttler — and never see a 429 you didn't ask for.
- [Resolve](https://docs.minerva.io/sdk/guides/resolve.md): Match your records to a unique Minerva PID. Lighter and cheaper than enrich when all you need is identity.
- [Spreadsheets — Google Sheets & Excel](https://docs.minerva.io/sdk/guides/spreadsheets.md): Run resolve / enrich directly off a Google Sheet or .xlsx workbook, and write results back the same way.
- [Streaming batcher](https://docs.minerva.io/sdk/guides/streaming-batcher.md): Feed records one at a time. `Batcher` (sync) and `AsyncBatcher` (async) buffer until the size cap is hit, then auto-fire any callable — enrich, resolve, or your own.
- [Usage tallies](https://docs.minerva.io/sdk/guides/usage.md): Your per-endpoint API usage — how many calls, when, against your key.
- [Email validation](https://docs.minerva.io/sdk/guides/validate-emails.md): Verify email addresses against the Minerva database.
- [Validation & dry_run](https://docs.minerva.io/sdk/guides/validation-dry-run.md): Validate input locally before any network round-trip — same checks the server runs, available offline.
- [Workflows — `mc.workflows.*`](https://docs.minerva.io/sdk/guides/workflows.md): Encoded best-practice multi-call recipes. Start with `resolve_then_enrich` — the faster path for going from names/emails to full profiles.
- [Installation](https://docs.minerva.io/sdk/installation.md): pip install minerva-sdk — plus opt-in extras for pandas DataFrames and pretty terminal tables.
- [Minerva Python SDK](https://docs.minerva.io/sdk/introduction.md): One client for the Minerva Data API. Typed end-to-end. Input validation before any call hits the network.
- [Quickstart](https://docs.minerva.io/sdk/quickstart.md): Install, set your API key, run your first enrichment.
- [CLI reference](https://docs.minerva.io/sdk/reference/cli.md): python -m minerva — a help screen + cheat-sheet for users who installed the SDK and aren't sure where to start.
- [Exception reference](https://docs.minerva.io/sdk/reference/errors.md): Every exception the SDK raises, what triggers it, and what context it carries.

## OpenAPI Specs

- [openapi](https://docs.minerva.io/api-reference/openapi.json)