{ "code": "bad_request", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "8931445e-91f1-42c6-a53d-7381de862dc8"}
{ "code": "payload_too_large", "message": "Maximum number of records for /v2/resolve endpoint is 1000", "api_request_id": "e5f6a7b8-c9d0-1234-ef56-7890abcdef01"}
{ "code": "unprocessable_entity", "message": "Input data must be a JSON object", "api_request_id": "f6a7b8c9-d0e1-2345-f678-90abcdef0123"}
Resolve
Resolve v2
Enhanced resolve with reverse lookup capabilities and match condition filters
{ "code": "bad_request", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "8931445e-91f1-42c6-a53d-7381de862dc8"}
{ "code": "payload_too_large", "message": "Maximum number of records for /v2/resolve endpoint is 1000", "api_request_id": "e5f6a7b8-c9d0-1234-ef56-7890abcdef01"}
{ "code": "unprocessable_entity", "message": "Input data must be a JSON object", "api_request_id": "f6a7b8c9-d0e1-2345-f678-90abcdef0123"}
How do I resolve a person’s identity? Use this endpoint to find someone’s Minerva PID (person identifier) and LinkedIn URL based on their name, email, or phone number.Common questions this endpoint answers:
How do I match a person to get their ID?
How do I find someone’s Minerva PID?
How do I look up a person by email?
How do I search for someone by phone number?
How do I get a person’s LinkedIn profile?
How can I identify someone from basic contact information?
How do I deduplicate or match records to unique people?
What you need: Name and/or contact information (email or phone).What you get back: Minerva PID (unique person identifier) and LinkedIn URL if available.Use cases:
Get a person’s PID to use with other endpoints (enrich, segments)
Match email addresses or phone numbers to unique individuals
The V2 Resolve endpoint provides enhanced identity resolution with two powerful matching modes: traditional fuzzy matching and reverse lookup. This version improves flexibility and adds LinkedIn URL to the response.
New in V2: Optional list of fields that must be present in the matched record for it to be returned as a match. This filters results to only include matches that have these data fields available.Valid options: minerva_pid, linkedin_urlExample: ["linkedin_url"] will only return matches that have a LinkedIn profileExample: ["minerva_pid", "linkedin_url"] will only return matches that have both
Confidence score for the match, as an additive point total — not a 0-1 or
0-100 scale. Fuzzy matches score at least 50 and routinely exceed 100; reverse
lookups are fixed at 50.0. null unless is_match is true. See
Interpreting match_score.
Object containing any validation errors encountered with the input data
Error responses include statusCode and body fields for backward compatibility with existing integrations. These are deprecated — prefer the HTTP status code and the top-level code / message / api_request_id fields directly. (The deprecated nested body still carries the legacy error_message.)
{ "code": "bad_request", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "8931445e-91f1-42c6-a53d-7381de862dc8"}
{ "code": "payload_too_large", "message": "Maximum number of records for /v2/resolve endpoint is 1000", "api_request_id": "e5f6a7b8-c9d0-1234-ef56-7890abcdef01"}
{ "code": "unprocessable_entity", "message": "Input data must be a JSON object", "api_request_id": "f6a7b8c9-d0e1-2345-f678-90abcdef0123"}
match_score is an additive point total, not a normalized 0-1 or 0-100
confidence. For a fuzzy match it is the sum of two components:
Name — up to 60 points, based on how closely the input name matches the
person’s known names and aliases
Contact info — points for every input email and phone that matches the
person, weighted by how strongly that email or phone is associated with them
Because the contact-info component grows with each additional match, there is no
upper bound: a record matched on a name plus several emails and phones commonly
scores 110-130. Every fuzzy match returned with is_match: true has already
cleared Minerva’s internal threshold and scores at least 50.
Compare scores against each other, not against a fixed ceiling. Thresholding
on a percentage (for example, “accept above 0.8” or “above 80%”) will not
behave the way you expect.
Reverse lookups don’t run the scoring algorithm at all — they match a single
email or phone directly — so they return a fixed 50.0. That value carries no
information about match quality, and comparing it against a fuzzy score is
meaningless. match_score is null when is_match is false, and scores are
rounded to two decimal places.If you need stricter results, prefer match_condition_fields over a score
threshold: it filters on which data is actually populated, which is both
verifiable and stable across matching modes.
A timed-out request returns HTTP 504 with code: "dependency_timeout" and an
api_request_id for support. Retry after a short delay.
A request timeout does not imply a missing match.
Name is now optional if you provide contact information
New linkedin_url field in response
Use reverse lookup for faster email/phone-only matching
Use match_condition_fields to filter results by data availability
Match scores may differ slightly due to improved algorithm
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Minerva Documentation","colors":{"primary":"#5B84E7","light":"#8EA8F0","dark":"#2E5BCF"},"logo":{"light":"https://mintcdn.com/minerva-a2a15a3a/4LFBmther9gqOLci/logo/Logo+Wordmark.svg?fit=max\u0026auto=format\u0026n=4LFBmther9gqOLci\u0026q=85\u0026s=80dfff22f85e3503c13e452578128b42","dark":"https://mintcdn.com/minerva-a2a15a3a/4LFBmther9gqOLci/logo/Logo+Wordmark_White.svg?fit=max\u0026auto=format\u0026n=4LFBmther9gqOLci\u0026q=85\u0026s=a312b4352c94561aaf43d34d331bb324"},"favicon":"https://mintcdn.com/minerva-a2a15a3a/taSOw2M7XeR05kge/favicon.svg?fit=max\u0026auto=format\u0026n=taSOw2M7XeR05kge\u0026q=85\u0026s=a062b886b18b17632a5788847a537418","api":{"playground":{"display":"simple"},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.minerva.io"}},"fonts":{"heading":{"family":"ES Schwarzweiss","weight":700,"source":"fonts/ESSchwarzweiss-Variable.woff2","format":"woff2"},"body":{"family":"ES Schwarzweiss","weight":400,"source":"fonts/ESSchwarzweiss-Variable.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minerva-a2a15a3a","hasAudioNarration":false,"actualSubdomain":"minerva-a2a15a3a","customDomains":["docs.minerva.io"],"gitSource":{"type":"github","owner":"minervadata-hq","repo":"md-core","deployBranch":"prod","contentDirectory":"docs/api_sdk/mintlify","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6aecd8a42ce0e78217a380cc","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"SDK","count":24},{"language":"default","tag":"Person Search","count":11},{"language":"default","tag":"Power features","count":11},{"language":"default","tag":"Endpoints","count":7},{"language":"default","tag":"Core Endpoints","count":6},{"language":"default","tag":"Segments","count":5},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Async Person Search","count":4},{"language":"default","tag":"MCP","count":4}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/resolve-v2","slug":"/api-reference/resolve-v2","pageMetadata":{"title":"Resolve v2","api":"POST https://api.minerva.io/v2/resolve","description":"Enhanced resolve with reverse lookup capabilities and match condition filters","authMethod":"key","href":"/api-reference/resolve-v2"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Enhanced resolve with reverse lookup capabilities and match condition filters\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(`div`,{style:{display:`none`},\"aria-hidden\":`false`,children:[_jsx(Heading,{level:`2`,id:`quick-answer`,children:`Quick Answer`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`How do I resolve a person’s identity?`}),` Use this endpoint to find someone’s Minerva PID (person identifier) and LinkedIn URL based on their name, email, or phone number.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Common questions this endpoint answers:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`How do I match a person to get their ID?`}),`\n`,_jsx(_components.li,{children:`How do I find someone’s Minerva PID?`}),`\n`,_jsx(_components.li,{children:`How do I look up a person by email?`}),`\n`,_jsx(_components.li,{children:`How do I search for someone by phone number?`}),`\n`,_jsx(_components.li,{children:`How do I get a person’s LinkedIn profile?`}),`\n`,_jsx(_components.li,{children:`How can I identify someone from basic contact information?`}),`\n`,_jsx(_components.li,{children:`How do I deduplicate or match records to unique people?`}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you need:`}),` Name and/or contact information (email or phone).`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you get back:`}),` Minerva PID (unique person identifier) and LinkedIn URL if available.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use cases:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Get a person’s PID to use with other endpoints (enrich, segments)`}),`\n`,_jsx(_components.li,{children:`Match email addresses or phone numbers to unique individuals`}),`\n`,_jsx(_components.li,{children:`Find LinkedIn profiles for contacts`}),`\n`,_jsx(_components.li,{children:`Deduplicate customer records`}),`\n`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`The V2 Resolve endpoint provides enhanced identity resolution with two powerful matching modes: traditional fuzzy matching and reverse lookup. This version improves flexibility and adds LinkedIn URL to the response.`}),`\n`,_jsx(Heading,{level:`2`,id:`key-enhancements-in-v2`,children:`Key Enhancements in V2`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reverse Lookup`}),`: Resolve by single email or phone without requiring a name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LinkedIn URL`}),`: Returns LinkedIn profile URL in addition to Minerva PID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Match Condition Filters`}),`: Ensure matched records have specific data fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Flexible Name Requirements`}),`: Name is optional when contact information is provided`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Optional Record ID`}),`: Record ID is now optional for V2`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Your API key for authentication`})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:`application/json`})}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(ParamField,{body:`records`,type:`object[]`,required:true,id:`param-records`,children:[_jsx(_components.p,{children:`An array of person records to resolve. Maximum 1000 records per request.`}),_jsxs(Expandable,{title:`Record object properties`,children:[_jsx(ParamField,{body:`record_id`,type:`string`,id:`param-record-id`,children:_jsx(_components.p,{children:`Your unique identifier for this record (optional in V2)`})}),_jsx(ParamField,{body:`first_name`,type:`string`,id:`param-first-name`,children:_jsx(_components.p,{children:`Person’s first name`})}),_jsx(ParamField,{body:`middle_name`,type:`string`,id:`param-middle-name`,children:_jsx(_components.p,{children:`Person’s middle name`})}),_jsx(ParamField,{body:`last_name`,type:`string`,id:`param-last-name`,children:_jsx(_components.p,{children:`Person’s last name`})}),_jsx(ParamField,{body:`full_name`,type:`string`,id:`param-full-name`,children:_jsx(_components.p,{children:`Person’s full name (alternative to first/last name)`})}),_jsx(ParamField,{body:`name_suffix`,type:`string`,id:`param-name-suffix`,children:_jsx(_components.p,{children:`Name suffix (e.g., “Jr.”, “Sr.”, “III”)`})}),_jsx(ParamField,{body:`emails`,type:`string[]`,id:`param-emails`,children:_jsx(_components.p,{children:`Array of email addresses`})}),_jsx(ParamField,{body:`phones`,type:`string[]`,id:`param-phones`,children:_jsx(_components.p,{children:`Array of phone numbers`})})]})]}),`\n`,_jsxs(ParamField,{body:`match_condition_fields`,type:`string[]`,id:`param-match-condition-fields`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New in V2`}),`: Optional list of fields that must be present in the matched record for it to be returned as a match. This filters results to only include matches that have these data fields available.`]}),_jsxs(_components.p,{children:[`Valid options: `,_jsx(_components.code,{children:`minerva_pid`}),`, `,_jsx(_components.code,{children:`linkedin_url`})]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`[\"linkedin_url\"]`}),` will only return matches that have a LinkedIn profile`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`[\"minerva_pid\", \"linkedin_url\"]`}),` will only return matches that have both`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-examples`,children:`Request Examples`}),`\n`,_jsx(Heading,{level:`4`,id:`standard-fuzzy-matching`,children:`Standard Fuzzy Matching`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Smith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"john.smith@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phones\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1-555-123-4567\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`reverse-lookup-email-only-no-name`,children:`Reverse Lookup (Email Only, No Name)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_002\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`reverse-lookup-phone-only-no-name`,children:`Reverse Lookup (Phone Only, No Name)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_003\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phones\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1-555-987-6543\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`with-match-condition-filter`,children:`With Match Condition Filter`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match_condition_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"linkedin_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`3`,id:`response-structure`,children:`Response Structure`}),`\n`,_jsx(ResponseField,{name:`api_request_id`,type:`string`,id:`param-api-request-id`,children:_jsx(_components.p,{children:`Unique identifier for this API request`})}),`\n`,_jsx(ResponseField,{name:`results`,type:`array`,id:`param-results`,children:_jsx(_components.p,{children:`Array of resolution results, one per input record`})}),`\n`,_jsx(ResponseField,{name:`request_completed_at`,type:`string`,id:`param-request-completed-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp when the request was completed`})}),`\n`,_jsx(Heading,{level:`4`,id:`result-object`,children:`Result Object`}),`\n`,_jsx(ResponseField,{name:`record_id`,type:`string`,id:`param-record-id-1`,children:_jsx(_components.p,{children:`Your identifier from the request (may be null if not provided)`})}),`\n`,_jsx(ResponseField,{name:`is_match`,type:`boolean`,id:`param-is-match`,children:_jsx(_components.p,{children:`Whether a match was found in the Minerva database`})}),`\n`,_jsx(ResponseField,{name:`minerva_pid`,type:`string`,id:`param-minerva-pid`,children:_jsx(_components.p,{children:`Minerva person identifier (only present if is_match is true)`})}),`\n`,_jsx(ResponseField,{name:`linkedin_url`,type:`string`,id:`param-linkedin-url`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New in V2`}),`: LinkedIn profile URL (only present if is_match is true and LinkedIn data is available)`]})}),`\n`,_jsx(ResponseField,{name:`match_score`,type:`number`,id:`param-match-score`,children:_jsxs(_components.p,{children:[`Confidence score for the match, as an additive point total — `,_jsx(_components.strong,{children:`not`}),` a 0-1 or\n0-100 scale. Fuzzy matches score at least 50 and routinely exceed 100; reverse\nlookups are fixed at `,_jsx(_components.code,{children:`50.0`}),`. `,_jsx(_components.code,{children:`null`}),` unless `,_jsx(_components.code,{children:`is_match`}),` is true. See\n`,_jsxs(_components.a,{href:`#interpreting-match-score`,children:[`Interpreting `,_jsx(_components.code,{children:`match_score`})]}),`.`]})}),`\n`,_jsx(ResponseField,{name:`is_resolvable_record`,type:`boolean`,id:`param-is-resolvable-record`,children:_jsx(_components.p,{children:`Whether the input record had sufficient valid data to attempt resolution`})}),`\n`,_jsx(ResponseField,{name:`validation_errors`,type:`object`,id:`param-validation-errors`,children:_jsx(_components.p,{children:`Object containing any validation errors encountered with the input data`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Error responses include `,_jsx(_components.code,{children:`statusCode`}),` and `,_jsx(_components.code,{children:`body`}),` fields for backward compatibility with existing integrations. These are deprecated — prefer the HTTP status code and the top-level `,_jsx(_components.code,{children:`code`}),` / `,_jsx(_components.code,{children:`message`}),` / `,_jsx(_components.code,{children:`api_request_id`}),` fields directly. (The deprecated nested `,_jsx(_components.code,{children:`body`}),` still carries the legacy `,_jsx(_components.code,{children:`error_message`}),`.)`]})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,_jsx(Heading,{level:`3`,id:`common-errors`,children:`Common Errors`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400`}),` - Bad Request: Invalid input format or missing required fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401`}),` - Unauthorized: Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`413`}),` - Payload Too Large: More than 1000 records in request`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`422`}),` - Unprocessable Entity: Invalid data format or invalid `,_jsx(_components.code,{children:`match_condition_fields`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429`}),` - Too Many Requests: Rate limit exceeded`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500`}),` - Internal Server Error: Server error occurred`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsx(Heading,{level:`3`,id:`matching-modes`,children:`Matching Modes`}),`\n`,_jsx(_components.p,{children:`V2 supports two distinct matching modes:`}),`\n`,_jsx(Heading,{level:`4`,id:`1-fuzzy-matching-mode`,children:`1. Fuzzy Matching Mode`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide name information (first/last OR full_name) and/or contact information (emails/phones)`}),`\n`,_jsx(_components.li,{children:`At least one of name or contact info must be provided`}),`\n`,_jsx(_components.li,{children:`Uses advanced fuzzy matching algorithm`}),`\n`,_jsxs(_components.li,{children:[`Returns an additive `,_jsx(_components.code,{children:`match_score`}),` — at least 50, and often above 100`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`2-reverse-lookup-mode`,children:`2. Reverse Lookup Mode`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Activated when`}),`: No name provided AND exactly one email OR exactly one phone`]}),`\n`,_jsx(_components.li,{children:`Performs direct lookup in unique matching database`}),`\n`,_jsx(_components.li,{children:`Faster than fuzzy matching`}),`\n`,_jsx(_components.li,{children:`Returns match score of 50.0 for reverse lookup matches`}),`\n`,_jsx(_components.li,{children:`Does not support multiple emails or phones simultaneously`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`input-requirements`,children:`Input Requirements`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Fuzzy Matching:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide either name OR contact information (or both)`}),`\n`,_jsx(_components.li,{children:`If providing name, must include both first_name and last_name (or full_name)`}),`\n`,_jsx(_components.li,{children:`Can provide multiple emails and/or phones`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Reverse Lookup:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide exactly ONE email OR exactly ONE phone`}),`\n`,_jsx(_components.li,{children:`Do NOT provide name information`}),`\n`,_jsx(_components.li,{children:`Cannot provide both email and phone`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`match-condition-fields`,children:`Match Condition Fields`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`match_condition_fields`}),` to filter results based on data availability:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`minerva_pid`}),` - Only return matches where we have a Minerva PID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`linkedin_url`}),` - Only return matches where we have LinkedIn profile data`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This is useful when you need to ensure the matched person has specific data fields available before considering them a valid match.`}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`record_id`}),` is optional in requests and may be null in responses`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`linkedin_url`}),` is new in V2 and only returned when available`]}),`\n`]}),`\n`,_jsxs(Heading,{level:`3`,id:`interpreting-match_score`,children:[`Interpreting `,_jsx(_components.code,{children:`match_score`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`match_score`}),` is an `,_jsx(_components.strong,{children:`additive point total`}),`, not a normalized 0-1 or 0-100\nconfidence. For a fuzzy match it is the sum of two components:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),` — up to 60 points, based on how closely the input name matches the\nperson’s known names and aliases`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact info`}),` — points for every input email and phone that matches the\nperson, weighted by how strongly that email or phone is associated with them`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Because the contact-info component grows with each additional match, there is no\nupper bound: a record matched on a name plus several emails and phones commonly\nscores 110-130. Every fuzzy match returned with `,_jsx(_components.code,{children:`is_match: true`}),` has already\ncleared Minerva’s internal threshold and scores at least 50.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Compare scores against each other, not against a fixed ceiling. Thresholding\non a percentage (for example, “accept above 0.8” or “above 80%”) will not\nbehave the way you expect.`})}),`\n`,_jsxs(_components.p,{children:[`Reverse lookups don’t run the scoring algorithm at all — they match a single\nemail or phone directly — so they return a fixed `,_jsx(_components.code,{children:`50.0`}),`. That value carries no\ninformation about match quality, and comparing it against a fuzzy score is\nmeaningless. `,_jsx(_components.code,{children:`match_score`}),` is `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`is_match`}),` is false, and scores are\nrounded to two decimal places.`]}),`\n`,_jsxs(_components.p,{children:[`If you need stricter results, prefer `,_jsx(_components.code,{children:`match_condition_fields`}),` over a score\nthreshold: it filters on which data is actually populated, which is both\nverifiable and stable across matching modes.`]}),`\n`,_jsx(Heading,{level:`3`,id:`validation`,children:`Validation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Phone numbers must be valid US phone numbers`}),`\n`,_jsx(_components.li,{children:`Email addresses must be valid email format`}),`\n`,_jsx(_components.li,{children:`Names must have at least first and last name components`}),`\n`,_jsxs(_components.li,{children:[`Records that fail validation will have `,_jsx(_components.code,{children:`is_resolvable_record: false`}),` and details in `,_jsx(_components.code,{children:`validation_errors`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`timeouts`,children:`Timeouts`}),`\n`,_jsxs(_components.p,{children:[`A timed-out request returns HTTP `,_jsx(_components.code,{children:`504`}),` with `,_jsx(_components.code,{children:`code: \"dependency_timeout\"`}),` and an\n`,_jsx(_components.code,{children:`api_request_id`}),` for support. Retry after a short delay.\nA request timeout does not imply a missing match.`]}),`\n`,_jsx(Heading,{level:`2`,id:`migration-from-v1`,children:`Migration from V1`}),`\n`,_jsx(_components.p,{children:`If you’re upgrading from V1:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`URL changes from `,_jsx(_components.code,{children:`/v1/resolve`}),` to `,_jsx(_components.code,{children:`/v2/resolve`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`record_id`}),` is now optional (was required in V1)`]}),`\n`,_jsx(_components.li,{children:`Name is now optional if you provide contact information`}),`\n`,_jsxs(_components.li,{children:[`New `,_jsx(_components.code,{children:`linkedin_url`}),` field in response`]}),`\n`,_jsx(_components.li,{children:`Use reverse lookup for faster email/phone-only matching`}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`match_condition_fields`}),` to filter results by data availability`]}),`\n`,_jsx(_components.li,{children:`Match scores may differ slightly due to improved algorithm`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Resolve v2","api":"POST https://api.minerva.io/v2/resolve","description":"Enhanced resolve with reverse lookup capabilities and match condition filters","authMethod":"key","href":"/api-reference/resolve-v2"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(`div`,{style:{display:`none`},\"aria-hidden\":`false`,children:[_jsx(Heading,{level:`2`,id:`quick-answer`,children:`Quick Answer`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`How do I resolve a person’s identity?`}),` Use this endpoint to find someone’s Minerva PID (person identifier) and LinkedIn URL based on their name, email, or phone number.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Common questions this endpoint answers:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`How do I match a person to get their ID?`}),`\n`,_jsx(_components.li,{children:`How do I find someone’s Minerva PID?`}),`\n`,_jsx(_components.li,{children:`How do I look up a person by email?`}),`\n`,_jsx(_components.li,{children:`How do I search for someone by phone number?`}),`\n`,_jsx(_components.li,{children:`How do I get a person’s LinkedIn profile?`}),`\n`,_jsx(_components.li,{children:`How can I identify someone from basic contact information?`}),`\n`,_jsx(_components.li,{children:`How do I deduplicate or match records to unique people?`}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you need:`}),` Name and/or contact information (email or phone).`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you get back:`}),` Minerva PID (unique person identifier) and LinkedIn URL if available.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use cases:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Get a person’s PID to use with other endpoints (enrich, segments)`}),`\n`,_jsx(_components.li,{children:`Match email addresses or phone numbers to unique individuals`}),`\n`,_jsx(_components.li,{children:`Find LinkedIn profiles for contacts`}),`\n`,_jsx(_components.li,{children:`Deduplicate customer records`}),`\n`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`The V2 Resolve endpoint provides enhanced identity resolution with two powerful matching modes: traditional fuzzy matching and reverse lookup. This version improves flexibility and adds LinkedIn URL to the response.`}),`\n`,_jsx(Heading,{level:`2`,id:`key-enhancements-in-v2`,children:`Key Enhancements in V2`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reverse Lookup`}),`: Resolve by single email or phone without requiring a name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LinkedIn URL`}),`: Returns LinkedIn profile URL in addition to Minerva PID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Match Condition Filters`}),`: Ensure matched records have specific data fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Flexible Name Requirements`}),`: Name is optional when contact information is provided`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Optional Record ID`}),`: Record ID is now optional for V2`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Your API key for authentication`})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:`application/json`})}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(ParamField,{body:`records`,type:`object[]`,required:true,id:`param-records`,children:[_jsx(_components.p,{children:`An array of person records to resolve. Maximum 1000 records per request.`}),_jsxs(Expandable,{title:`Record object properties`,children:[_jsx(ParamField,{body:`record_id`,type:`string`,id:`param-record-id`,children:_jsx(_components.p,{children:`Your unique identifier for this record (optional in V2)`})}),_jsx(ParamField,{body:`first_name`,type:`string`,id:`param-first-name`,children:_jsx(_components.p,{children:`Person’s first name`})}),_jsx(ParamField,{body:`middle_name`,type:`string`,id:`param-middle-name`,children:_jsx(_components.p,{children:`Person’s middle name`})}),_jsx(ParamField,{body:`last_name`,type:`string`,id:`param-last-name`,children:_jsx(_components.p,{children:`Person’s last name`})}),_jsx(ParamField,{body:`full_name`,type:`string`,id:`param-full-name`,children:_jsx(_components.p,{children:`Person’s full name (alternative to first/last name)`})}),_jsx(ParamField,{body:`name_suffix`,type:`string`,id:`param-name-suffix`,children:_jsx(_components.p,{children:`Name suffix (e.g., “Jr.”, “Sr.”, “III”)`})}),_jsx(ParamField,{body:`emails`,type:`string[]`,id:`param-emails`,children:_jsx(_components.p,{children:`Array of email addresses`})}),_jsx(ParamField,{body:`phones`,type:`string[]`,id:`param-phones`,children:_jsx(_components.p,{children:`Array of phone numbers`})})]})]}),`\n`,_jsxs(ParamField,{body:`match_condition_fields`,type:`string[]`,id:`param-match-condition-fields`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New in V2`}),`: Optional list of fields that must be present in the matched record for it to be returned as a match. This filters results to only include matches that have these data fields available.`]}),_jsxs(_components.p,{children:[`Valid options: `,_jsx(_components.code,{children:`minerva_pid`}),`, `,_jsx(_components.code,{children:`linkedin_url`})]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`[\"linkedin_url\"]`}),` will only return matches that have a LinkedIn profile`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`[\"minerva_pid\", \"linkedin_url\"]`}),` will only return matches that have both`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-examples`,children:`Request Examples`}),`\n`,_jsx(Heading,{level:`4`,id:`standard-fuzzy-matching`,children:`Standard Fuzzy Matching`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Smith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"john.smith@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phones\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1-555-123-4567\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`reverse-lookup-email-only-no-name`,children:`Reverse Lookup (Email Only, No Name)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_002\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`reverse-lookup-phone-only-no-name`,children:`Reverse Lookup (Phone Only, No Name)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_003\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phones\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+1-555-987-6543\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`with-match-condition-filter`,children:`With Match Condition Filter`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match_condition_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"linkedin_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`3`,id:`response-structure`,children:`Response Structure`}),`\n`,_jsx(ResponseField,{name:`api_request_id`,type:`string`,id:`param-api-request-id`,children:_jsx(_components.p,{children:`Unique identifier for this API request`})}),`\n`,_jsx(ResponseField,{name:`results`,type:`array`,id:`param-results`,children:_jsx(_components.p,{children:`Array of resolution results, one per input record`})}),`\n`,_jsx(ResponseField,{name:`request_completed_at`,type:`string`,id:`param-request-completed-at`,children:_jsx(_components.p,{children:`ISO 8601 timestamp when the request was completed`})}),`\n`,_jsx(Heading,{level:`4`,id:`result-object`,children:`Result Object`}),`\n`,_jsx(ResponseField,{name:`record_id`,type:`string`,id:`param-record-id-1`,children:_jsx(_components.p,{children:`Your identifier from the request (may be null if not provided)`})}),`\n`,_jsx(ResponseField,{name:`is_match`,type:`boolean`,id:`param-is-match`,children:_jsx(_components.p,{children:`Whether a match was found in the Minerva database`})}),`\n`,_jsx(ResponseField,{name:`minerva_pid`,type:`string`,id:`param-minerva-pid`,children:_jsx(_components.p,{children:`Minerva person identifier (only present if is_match is true)`})}),`\n`,_jsx(ResponseField,{name:`linkedin_url`,type:`string`,id:`param-linkedin-url`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New in V2`}),`: LinkedIn profile URL (only present if is_match is true and LinkedIn data is available)`]})}),`\n`,_jsx(ResponseField,{name:`match_score`,type:`number`,id:`param-match-score`,children:_jsxs(_components.p,{children:[`Confidence score for the match, as an additive point total — `,_jsx(_components.strong,{children:`not`}),` a 0-1 or\n0-100 scale. Fuzzy matches score at least 50 and routinely exceed 100; reverse\nlookups are fixed at `,_jsx(_components.code,{children:`50.0`}),`. `,_jsx(_components.code,{children:`null`}),` unless `,_jsx(_components.code,{children:`is_match`}),` is true. See\n`,_jsxs(_components.a,{href:`#interpreting-match-score`,children:[`Interpreting `,_jsx(_components.code,{children:`match_score`})]}),`.`]})}),`\n`,_jsx(ResponseField,{name:`is_resolvable_record`,type:`boolean`,id:`param-is-resolvable-record`,children:_jsx(_components.p,{children:`Whether the input record had sufficient valid data to attempt resolution`})}),`\n`,_jsx(ResponseField,{name:`validation_errors`,type:`object`,id:`param-validation-errors`,children:_jsx(_components.p,{children:`Object containing any validation errors encountered with the input data`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Error responses include `,_jsx(_components.code,{children:`statusCode`}),` and `,_jsx(_components.code,{children:`body`}),` fields for backward compatibility with existing integrations. These are deprecated — prefer the HTTP status code and the top-level `,_jsx(_components.code,{children:`code`}),` / `,_jsx(_components.code,{children:`message`}),` / `,_jsx(_components.code,{children:`api_request_id`}),` fields directly. (The deprecated nested `,_jsx(_components.code,{children:`body`}),` still carries the legacy `,_jsx(_components.code,{children:`error_message`}),`.)`]})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`33`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`33`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_abc123xyz\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_match\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minerva_pid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"p-a1b2c3d4e5f6g7h8i9j0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"linkedin_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://www.linkedin.com/in/johnsmith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`110.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_resolvable_record\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"validation_errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_002\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_match\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minerva_pid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"p-b2c3d4e5f6a7b8c9d0e1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"linkedin_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://www.linkedin.com/in/janedoe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`50.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_resolvable_record\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"validation_errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"record_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_003\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_match\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minerva_pid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"linkedin_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_resolvable_record\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"validation_errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_completed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-11-12T19:19:25.679685+00:00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bad_request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Input data must contain a 'records' key with a list of inputs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8931445e-91f1-42c6-a53d-7381de862dc8\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unauthorized\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unauthorized\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c1d2e3f4-a5b6-7890-cdef-1234567890ab\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`413`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"payload_too_large\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Maximum number of records for /v2/resolve endpoint is 1000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e5f6a7b8-c9d0-1234-ef56-7890abcdef01\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`422`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unprocessable_entity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Input data must be a JSON object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f6a7b8c9-d0e1-2345-f678-90abcdef0123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,_jsx(Heading,{level:`3`,id:`common-errors`,children:`Common Errors`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400`}),` - Bad Request: Invalid input format or missing required fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401`}),` - Unauthorized: Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`413`}),` - Payload Too Large: More than 1000 records in request`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`422`}),` - Unprocessable Entity: Invalid data format or invalid `,_jsx(_components.code,{children:`match_condition_fields`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429`}),` - Too Many Requests: Rate limit exceeded`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500`}),` - Internal Server Error: Server error occurred`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsx(Heading,{level:`3`,id:`matching-modes`,children:`Matching Modes`}),`\n`,_jsx(_components.p,{children:`V2 supports two distinct matching modes:`}),`\n`,_jsx(Heading,{level:`4`,id:`1-fuzzy-matching-mode`,children:`1. Fuzzy Matching Mode`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide name information (first/last OR full_name) and/or contact information (emails/phones)`}),`\n`,_jsx(_components.li,{children:`At least one of name or contact info must be provided`}),`\n`,_jsx(_components.li,{children:`Uses advanced fuzzy matching algorithm`}),`\n`,_jsxs(_components.li,{children:[`Returns an additive `,_jsx(_components.code,{children:`match_score`}),` — at least 50, and often above 100`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`2-reverse-lookup-mode`,children:`2. Reverse Lookup Mode`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Activated when`}),`: No name provided AND exactly one email OR exactly one phone`]}),`\n`,_jsx(_components.li,{children:`Performs direct lookup in unique matching database`}),`\n`,_jsx(_components.li,{children:`Faster than fuzzy matching`}),`\n`,_jsx(_components.li,{children:`Returns match score of 50.0 for reverse lookup matches`}),`\n`,_jsx(_components.li,{children:`Does not support multiple emails or phones simultaneously`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`input-requirements`,children:`Input Requirements`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Fuzzy Matching:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide either name OR contact information (or both)`}),`\n`,_jsx(_components.li,{children:`If providing name, must include both first_name and last_name (or full_name)`}),`\n`,_jsx(_components.li,{children:`Can provide multiple emails and/or phones`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Reverse Lookup:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provide exactly ONE email OR exactly ONE phone`}),`\n`,_jsx(_components.li,{children:`Do NOT provide name information`}),`\n`,_jsx(_components.li,{children:`Cannot provide both email and phone`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`match-condition-fields`,children:`Match Condition Fields`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`match_condition_fields`}),` to filter results based on data availability:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`minerva_pid`}),` - Only return matches where we have a Minerva PID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`linkedin_url`}),` - Only return matches where we have LinkedIn profile data`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This is useful when you need to ensure the matched person has specific data fields available before considering them a valid match.`}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`record_id`}),` is optional in requests and may be null in responses`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`linkedin_url`}),` is new in V2 and only returned when available`]}),`\n`]}),`\n`,_jsxs(Heading,{level:`3`,id:`interpreting-match_score`,children:[`Interpreting `,_jsx(_components.code,{children:`match_score`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`match_score`}),` is an `,_jsx(_components.strong,{children:`additive point total`}),`, not a normalized 0-1 or 0-100\nconfidence. For a fuzzy match it is the sum of two components:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),` — up to 60 points, based on how closely the input name matches the\nperson’s known names and aliases`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact info`}),` — points for every input email and phone that matches the\nperson, weighted by how strongly that email or phone is associated with them`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Because the contact-info component grows with each additional match, there is no\nupper bound: a record matched on a name plus several emails and phones commonly\nscores 110-130. Every fuzzy match returned with `,_jsx(_components.code,{children:`is_match: true`}),` has already\ncleared Minerva’s internal threshold and scores at least 50.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Compare scores against each other, not against a fixed ceiling. Thresholding\non a percentage (for example, “accept above 0.8” or “above 80%”) will not\nbehave the way you expect.`})}),`\n`,_jsxs(_components.p,{children:[`Reverse lookups don’t run the scoring algorithm at all — they match a single\nemail or phone directly — so they return a fixed `,_jsx(_components.code,{children:`50.0`}),`. That value carries no\ninformation about match quality, and comparing it against a fuzzy score is\nmeaningless. `,_jsx(_components.code,{children:`match_score`}),` is `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`is_match`}),` is false, and scores are\nrounded to two decimal places.`]}),`\n`,_jsxs(_components.p,{children:[`If you need stricter results, prefer `,_jsx(_components.code,{children:`match_condition_fields`}),` over a score\nthreshold: it filters on which data is actually populated, which is both\nverifiable and stable across matching modes.`]}),`\n`,_jsx(Heading,{level:`3`,id:`validation`,children:`Validation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Phone numbers must be valid US phone numbers`}),`\n`,_jsx(_components.li,{children:`Email addresses must be valid email format`}),`\n`,_jsx(_components.li,{children:`Names must have at least first and last name components`}),`\n`,_jsxs(_components.li,{children:[`Records that fail validation will have `,_jsx(_components.code,{children:`is_resolvable_record: false`}),` and details in `,_jsx(_components.code,{children:`validation_errors`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`timeouts`,children:`Timeouts`}),`\n`,_jsxs(_components.p,{children:[`A timed-out request returns HTTP `,_jsx(_components.code,{children:`504`}),` with `,_jsx(_components.code,{children:`code: \"dependency_timeout\"`}),` and an\n`,_jsx(_components.code,{children:`api_request_id`}),` for support. Retry after a short delay.\nA request timeout does not imply a missing match.`]}),`\n`,_jsx(Heading,{level:`2`,id:`migration-from-v1`,children:`Migration from V1`}),`\n`,_jsx(_components.p,{children:`If you’re upgrading from V1:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`URL changes from `,_jsx(_components.code,{children:`/v1/resolve`}),` to `,_jsx(_components.code,{children:`/v2/resolve`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`record_id`}),` is now optional (was required in V1)`]}),`\n`,_jsx(_components.li,{children:`Name is now optional if you provide contact information`}),`\n`,_jsxs(_components.li,{children:[`New `,_jsx(_components.code,{children:`linkedin_url`}),` field in response`]}),`\n`,_jsx(_components.li,{children:`Use reverse lookup for faster email/phone-only matching`}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`match_condition_fields`}),` to filter results by data availability`]}),`\n`,_jsx(_components.li,{children:`Match scores may differ slightly due to improved algorithm`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Resolve v2","api":"POST https://api.minerva.io/v2/resolve","description":"Enhanced resolve with reverse lookup capabilities and match condition filters","authMethod":"key","href":"/api-reference/resolve-v2"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Quick Answer","slug":"quick-answer","depth":2,"children":[]},{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Key Enhancements in V2","slug":"key-enhancements-in-v2","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Request Body","slug":"request-body","depth":3,"children":[]},{"title":"Request Examples","slug":"request-examples","depth":3,"children":[]},{"title":"Standard Fuzzy Matching","slug":"standard-fuzzy-matching","depth":4,"children":[]},{"title":"Reverse Lookup (Email Only, No Name)","slug":"reverse-lookup-email-only-no-name","depth":4,"children":[]},{"title":"Reverse Lookup (Phone Only, No Name)","slug":"reverse-lookup-phone-only-no-name","depth":4,"children":[]},{"title":"With Match Condition Filter","slug":"with-match-condition-filter","depth":4,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Response Structure","slug":"response-structure","depth":3,"children":[]},{"title":"Result Object","slug":"result-object","depth":4,"children":[]}]},{"title":"Error Responses","slug":"error-responses","depth":2,"children":[{"title":"Common Errors","slug":"common-errors","depth":3,"children":[]}]},{"title":"Notes","slug":"notes","depth":2,"children":[{"title":"Matching Modes","slug":"matching-modes","depth":3,"children":[]},{"title":"1. Fuzzy Matching Mode","slug":"1-fuzzy-matching-mode","depth":4,"children":[]},{"title":"2. Reverse Lookup Mode","slug":"2-reverse-lookup-mode","depth":4,"children":[]},{"title":"Input Requirements","slug":"input-requirements","depth":3,"children":[]},{"title":"Match Condition Fields","slug":"match-condition-fields","depth":3,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":3,"children":[]},{"title":"Interpreting match_score","slug":"interpreting-match_score","depth":3,"children":[]},{"title":"Validation","slug":"validation","depth":3,"children":[]}]},{"title":"Timeouts","slug":"timeouts","depth":2,"children":[]},{"title":"Migration from V1","slug":"migration-from-v1","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"33\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_abc123xyz\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"results\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"record_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"user_001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_match\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"minerva_pid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"p-a1b2c3d4e5f6g7h8i9j0\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"linkedin_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://www.linkedin.com/in/johnsmith\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"match_score\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">110.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_resolvable_record\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"validation_errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"record_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"user_002\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_match\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"minerva_pid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"p-b2c3d4e5f6a7b8c9d0e1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"linkedin_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://www.linkedin.com/in/janedoe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"match_score\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">50.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_resolvable_record\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"validation_errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"record_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"user_003\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_match\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"minerva_pid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"linkedin_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"match_score\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_resolvable_record\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"validation_errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_completed_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2025-11-12T19:19:25.679685+00:00\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"bad_request\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Input data must contain a 'records' key with a list of inputs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"8931445e-91f1-42c6-a53d-7381de862dc8\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"401","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"unauthorized\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Unauthorized\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"c1d2e3f4-a5b6-7890-cdef-1234567890ab\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"413","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"payload_too_large\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Maximum number of records for /v2/resolve endpoint is 1000\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"e5f6a7b8-c9d0-1234-ef56-7890abcdef01\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"422","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"unprocessable_entity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Input data must be a JSON object\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"f6a7b8c9-d0e1-2345-f678-90abcdef0123\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Resolve v2","path":"/v2/resolve","servers":[{"url":"https://api.minerva.io"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"x-api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"x-api-key":{"schema":[{"type":"string","description":"Your API key for authentication","required":true}]},"Content-Type":{"schema":[{"type":"string","description":"application/json","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"records":[{"type":"array","items":[{"type":"object","properties":{"record_id":[{"type":"string","description":"Your unique identifier for this record (optional in V2)"}],"first_name":[{"type":"string","description":"Person’s first name"}],"middle_name":[{"type":"string","description":"Person’s middle name"}],"last_name":[{"type":"string","description":"Person’s last name"}],"full_name":[{"type":"string","description":"Person’s full name (alternative to first/last name)"}],"name_suffix":[{"type":"string","description":"Name suffix (e.g., “Jr.”, “Sr.”, “III”)"}],"emails":[{"type":"array","items":[{"type":"string"}],"description":"Array of email addresses"}],"phones":[{"type":"array","items":[{"type":"string"}],"description":"Array of phone numbers"}]}}],"description":"An array of person records to resolve. Maximum 1000 records per request.","required":true}],"match_condition_fields":[{"type":"array","items":[{"type":"string"}],"description":"New in V2 : Optional list of fields that must be present in the matched record for it to be returned as a match. This filters results to only include matches that have these data fields available. Valid options: `minerva_pid` , `linkedin_url` Example: `[\"linkedin_url\"]` will only return matches that have a LinkedIn profile Example: `[\"minerva_pid\", \"linkedin_url\"]` will only return matches that have both"}]}}],"examples":{"example":{"value":{"records":[{"record_id":"\u003cstring>","first_name":"\u003cstring>","middle_name":"\u003cstring>","last_name":"\u003cstring>","full_name":"\u003cstring>","name_suffix":"\u003cstring>","emails":["\u003cstring>"],"phones":["\u003cstring>"]}],"match_condition_fields":["\u003cstring>"]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"api_request_id":[{"type":"string","description":"Unique identifier for this API request"}],"results":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Array of resolution results, one per input record"}],"request_completed_at":[{"type":"string","description":"ISO 8601 timestamp when the request was completed"}],"record_id":[{"type":"string","description":"Your identifier from the request (may be null if not provided)"}],"is_match":[{"type":"boolean","description":"Whether a match was found in the Minerva database"}],"minerva_pid":[{"type":"string","description":"Minerva person identifier (only present if is_match is true)"}],"linkedin_url":[{"type":"string","description":"New in V2 : LinkedIn profile URL (only present if is_match is true and LinkedIn data is available)"}],"match_score":[{"type":"number","description":"Confidence score for the match, as an additive point total — not a 0-1 or 0-100 scale. Fuzzy matches score at least 50 and routinely exceed 100; reverse lookups are fixed at `50.0` . `null` unless `is_match` is true. See Interpreting `match_score` ."}],"is_resolvable_record":[{"type":"boolean","description":"Whether the input record had sufficient valid data to attempt resolution"}],"validation_errors":[{"type":"object","properties":{},"description":"Object containing any validation errors encountered with the input data"}]}}],"examples":{"example":{"value":{"api_request_id":"\u003cstring>","results":[{}],"request_completed_at":"\u003cstring>","record_id":"\u003cstring>","is_match":true,"minerva_pid":"\u003cstring>","linkedin_url":"\u003cstring>","match_score":123,"is_resolvable_record":true,"validation_errors":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"minerva-a2a15a3a","siteName":"Minerva Documentation","title":"Resolve v2 - Minerva Documentation","contextualStarterQuestions":[{"_id":"6ad286f8fc0dfa1061cee563","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"Can I look up by email alone?","status":"active","generatedBy":"contextual","path":"api-reference/resolve-v2","createdAt":"2026-10-16T20:20:08.255Z","updatedAt":"2026-10-16T20:20:08.255Z","__v":0},{"_id":"6ad286f8fc0dfa1061cee564","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"What data do I get back?","status":"active","generatedBy":"contextual","path":"api-reference/resolve-v2","createdAt":"2026-10-16T20:20:08.255Z","updatedAt":"2026-10-16T20:20:08.255Z","__v":0},{"_id":"6ad286f8fc0dfa1061cee562","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"How do I find a person's PID?","status":"active","generatedBy":"contextual","path":"api-reference/resolve-v2","createdAt":"2026-10-16T20:20:08.254Z","updatedAt":"2026-10-16T20:20:08.254Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T20:20:05.634Z","originalFileLocation":"api-reference/resolve-v2.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Enhanced resolve with reverse lookup capabilities and match condition filters\">\u003cmeta data-mint-head name=\"application-name\" content=\"Minerva Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Resolve v2 - Minerva Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Enhanced resolve with reverse lookup capabilities and match condition filters\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Minerva Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.minerva.io/api-reference/resolve-v2\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://minerva-a2a15a3a.mintlify.site/_mintlify/api/og/v2?division=Resolve\u0026amp;title=Resolve+v2\u0026amp;description=Enhanced+resolve+with+reverse+lookup+capabilities+and+match+condition+filters\u0026amp;theme=e97f3b1d1117a7b9cb640af6\u0026amp;signature=e3f3c4ed202964ac2b4194f612f30d021a3530a926f4cf556e6468e2293ee8bc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Resolve v2 - Minerva Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Enhanced resolve with reverse lookup capabilities and match condition filters\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minerva-a2a15a3a.mintlify.site/_mintlify/api/og/v2?division=Resolve\u0026amp;title=Resolve+v2\u0026amp;description=Enhanced+resolve+with+reverse+lookup+capabilities+and+match+condition+filters\u0026amp;theme=e97f3b1d1117a7b9cb640af6\u0026amp;signature=e3f3c4ed202964ac2b4194f612f30d021a3530a926f4cf556e6468e2293ee8bc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/minerva-a2a15a3a/friUgrjnS8NK6ZsS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Minerva Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5B84E7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.minerva.io/api-reference/resolve-v2\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/resolve-v2.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.minerva.io/#organization\",\"name\":\"Minerva Documentation\",\"url\":\"https://docs.minerva.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/minerva-a2a15a3a/4LFBmther9gqOLci/logo/Logo+Wordmark.svg?fit=max\u0026auto=format\u0026n=4LFBmther9gqOLci\u0026q=85\u0026s=80dfff22f85e3503c13e452578128b42\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.minerva.io#website\",\"name\":\"Minerva Documentation\",\"url\":\"https://docs.minerva.io\",\"publisher\":{\"@id\":\"https://docs.minerva.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.minerva.io/api-reference/resolve-v2#webpage\",\"url\":\"https://docs.minerva.io/api-reference/resolve-v2\",\"name\":\"Resolve v2\",\"description\":\"Enhanced resolve with reverse lookup capabilities and match condition filters\",\"dateModified\":\"2026-10-16T20:20:05.634Z\",\"isPartOf\":{\"@id\":\"https://docs.minerva.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.minerva.io/api-reference/resolve-v2#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.minerva.io/api-reference/resolve-v2#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Minerva Documentation\",\"item\":\"https://docs.minerva.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resolve v2\",\"item\":\"https://docs.minerva.io/api-reference/resolve-v2\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.minerva.io/api-reference/resolve-v2#apireference\",\"headline\":\"Resolve v2\",\"name\":\"Resolve v2\",\"description\":\"Enhanced resolve with reverse lookup capabilities and match condition filters\",\"url\":\"https://docs.minerva.io/api-reference/resolve-v2\",\"mainEntityOfPage\":{\"@id\":\"https://docs.minerva.io/api-reference/resolve-v2#webpage\"},\"dateModified\":\"2026-10-16T20:20:05.634Z\",\"publisher\":{\"@id\":\"https://docs.minerva.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.minerva.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Minerva Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Minerva Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/resolve-v2.md","siteName":"Minerva Documentation","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Data Dictionary","description":"Complete reference of all fields returned by the Minerva Enrich v2 API","href":"/api-reference/data-dictionary"}]},{"group":"Core Endpoints","pages":[{"group":"Resolve","expanded":true,"pages":[{"title":"Resolve v2","api":"POST https://api.minerva.io/v2/resolve","href":"/api-reference/resolve-v2"},{"title":"Resolve v1","api":"POST https://api.minerva.io/v1/resolve","deprecated":true,"description":"\u003cWarning>**Do not use Resolve v1.** This endpoint is deprecated and remains available only for backward compatibility. Use [Resolve v2](/api-reference/resolve-v2) for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\u003c/Warning>","href":"/api-reference/resolve"}]},{"group":"Enrich","expanded":true,"pages":[{"title":"Enrich Input Rules","href":"/api-reference/enrich-inputs"},{"title":"Enrich v2","api":"POST https://api.minerva.io/v2/enrich","href":"/api-reference/enrich-v2"},{"title":"Enrich v1","api":"POST https://api.minerva.io/v1/enrich","deprecated":true,"href":"/api-reference/enrich"}]},{"title":"Get LinkedIn Contact Info","api":"POST https://api.minerva.io/v2/get_li_contact_info","href":"/api-reference/get-li-contact-info"}]},{"group":"Validation Workflows","pages":[{"title":"Validate Emails","api":"POST https://api.minerva.io/v2/validate_emails","href":"/api-reference/validate-emails"},{"title":"Infer Record Country","api":"POST https://api.minerva.io/v2/infer_record_country","href":"/api-reference/infer-record-country"}]},{"group":"Person Search","pages":[{"title":"Person Search","api":"POST https://api.minerva.io/person-search/v0/search","href":"/api-reference/person-search"},{"title":"Get Person Search","api":"GET https://api.minerva.io/person-search/v0/search/{search_id}","href":"/api-reference/person-search-get"},{"group":"Async Person Search","expanded":true,"pages":[{"title":"Async Person Search","sidebarTitle":"Async Search Flow","href":"/api-reference/person-search-async"},{"title":"Async Person Search","sidebarTitle":"1. Submit Search","api":"POST https://api.minerva.io/person-search/v0/search-jobs","href":"/api-reference/person-search-job-submit"},{"title":"Async Person Search Status","sidebarTitle":"2. Poll Status","api":"GET https://api.minerva.io/person-search/v0/search-jobs/{segment_id}","href":"/api-reference/person-search-job-status"},{"title":"Async Person Search Results","sidebarTitle":"3. Page Results","api":"GET https://api.minerva.io/person-search/v0/search-jobs/{segment_id}/results","href":"/api-reference/person-search-job-results"}]},{"title":"Person Search Usage","api":"GET https://api.minerva.io/person-search/v0/usage","href":"/api-reference/person-search-usage"},{"title":"Contact Append","api":"POST https://api.minerva.io/person-search/v0/contact-append","href":"/api-reference/person-search-contact-append"},{"title":"Contact Prospect","api":"POST https://api.minerva.io/person-search/v0/contact-prospect","href":"/api-reference/person-search-contact-prospect"},{"title":"Contact Job Status","api":"GET https://api.minerva.io/person-search/v0/contact-jobs/{job_id}","href":"/api-reference/person-search-contact-job"},{"title":"Contact Job Results","api":"POST https://api.minerva.io/person-search/v0/contact-jobs/{job_id}/results","href":"/api-reference/person-search-contact-job-results"}]},{"group":"Usage","pages":[{"title":"Endpoint Usage","api":"GET https://api.minerva.io/usage","href":"/api-reference/usage-endpoints"},{"title":"Billing Usage","api":"GET https://api.minerva.io/billing/usage","href":"/api-reference/billing-usage"}]},{"group":"Storage","pages":[{"title":"Storage — Boto Credentials","api":"POST https://api.minerva.io/storage/boto","href":"/api-reference/storage-boto"}]},{"group":"Segments","pages":[{"title":"Segments - Create","api":"POST https://api.minerva.io/v2/segments/create","href":"/api-reference/segments-create"},{"title":"Segments - Members","api":"GET https://api.minerva.io/v2/segments/members","href":"/api-reference/segments-members"},{"title":"Segments - Add Members","api":"POST https://api.minerva.io/v2/segments/members/add","href":"/api-reference/segments-members-add"},{"title":"Segments - Remove Members","api":"POST https://api.minerva.io/v2/segments/members/remove","href":"/api-reference/segments-members-remove"},{"title":"Segments - Death Signals","api":"GET https://api.minerva.io/v2/segments/signals/deaths","href":"/api-reference/segments-signals-deaths"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/minerva-data-mcp"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/introduction"}]},{"tab":"SFTP","pages":[{"title":"SFTP","href":"/sftp/introduction"}]}]},"basePath":"","title":"Resolve v2 - Minerva Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js"]}