{ "code": "payload_too_large", "message": "Maximum number of records for /v1/resolve endpoint is 1000", "api_request_id": "d4e5f6a7-b8c9-3456-def0-234567890123"}
{ "code": "unprocessable_entity", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "e5f6a7b8-c9d0-4567-ef01-345678901234"}
{ "code": "rate_limit_reached", "message": "You reached your total request-rate limit, please contact help@minerva.io for help", "api_request_id": "f6a7b8c9-d0e1-5678-f012-456789012345"}
Resolve
Resolve v1
Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.
{ "code": "payload_too_large", "message": "Maximum number of records for /v1/resolve endpoint is 1000", "api_request_id": "d4e5f6a7-b8c9-3456-def0-234567890123"}
{ "code": "unprocessable_entity", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "e5f6a7b8-c9d0-4567-ef01-345678901234"}
{ "code": "rate_limit_reached", "message": "You reached your total request-rate limit, please contact help@minerva.io for help", "api_request_id": "f6a7b8c9-d0e1-5678-f012-456789012345"}
How do I resolve a person’s identity? Do not use Resolve v1. Use Resolve v2 instead. Resolve v1 is deprecated and remains available only for backward compatibility.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 identify someone from their name and email?
How can I deduplicate or match records?
How do I get a unique identifier for a contact?
What you need: Name (first + last or full name) AND contact information (email or phone).What you get back: Minerva PID (unique person identifier) and match confidence score.Required action: Migrate existing /v1/resolve integrations to /v2/resolve as soon as possible.
The Resolve v1 endpoint matches person identity data (name, email, phone) to a
unique Minerva Person ID (minerva_pid). This is typically the first step
before enriching person data. The endpoint uses fuzzy matching to handle
variations in names and contact information. This reference remains available
only to support migrations from v1 to Resolve v2.
Confidence score for the match, as an additive point total — not a 0-1 or
0-100 scale. Matches score at least 50 and routinely exceed 100. 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": "payload_too_large", "message": "Maximum number of records for /v1/resolve endpoint is 1000", "api_request_id": "d4e5f6a7-b8c9-3456-def0-234567890123"}
{ "code": "unprocessable_entity", "message": "Input data must contain a 'records' key with a list of inputs", "api_request_id": "e5f6a7b8-c9d0-4567-ef01-345678901234"}
{ "code": "rate_limit_reached", "message": "You reached your total request-rate limit, please contact help@minerva.io for help", "api_request_id": "f6a7b8c9-d0e1-5678-f012-456789012345"}
match_score is an additive point total, not a normalized 0-1 or 0-100
confidence. 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. The example above scores 110.0.
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.
Practical guidance:
Every record returned with is_match: true already cleared Minerva’s internal
match threshold and scores at least 50. You don’t need your own floor
unless you want to be stricter than Minerva.
Reverse lookup capabilities (email or phone only, no name required)
LinkedIn URL in response
Match condition filters to ensure data availability
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","slug":"/api-reference/resolve","pageMetadata":{"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>","authMethod":"key","href":"/api-reference/resolve"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Warning} = _components;\n if (!Warning) _missingMdxReference(\"Warning\", true);\n return _jsxs(Warning, {\n children: [_jsx(_components.strong, {\n children: \"Do not use Resolve v1.\"\n }), \" This endpoint is deprecated and remains available only for backward compatibility. Use \", _jsx(_components.a, {\n href: \"/api-reference/resolve-v2\",\n children: \"Resolve v2\"\n }), \" for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\"]\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};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\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`,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?`}),` Do not use Resolve v1. Use `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),` instead. Resolve v1 is deprecated and remains available only for backward compatibility.`]}),_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 identify someone from their name and email?`}),`\n`,_jsx(_components.li,{children:`How can I deduplicate or match records?`}),`\n`,_jsx(_components.li,{children:`How do I get a unique identifier for a contact?`}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you need:`}),` Name (first + last or full name) AND contact information (email or phone).`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you get back:`}),` Minerva PID (unique person identifier) and match confidence score.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required action:`}),` Migrate existing `,_jsx(_components.code,{children:`/v1/resolve`}),` integrations to `,_jsx(_components.code,{children:`/v2/resolve`}),` as soon as possible.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`The Resolve v1 endpoint matches person identity data (name, email, phone) to a\nunique Minerva Person ID (`,_jsx(_components.code,{children:`minerva_pid`}),`). This is typically the first step\nbefore enriching person data. The endpoint uses fuzzy matching to handle\nvariations in names and contact information. This reference remains available\nonly to support migrations from v1 to `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),`.`]}),`\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`,required:true,id:`param-record-id`,children:_jsx(_components.p,{children:`Your unique identifier for this record`})}),_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`,_jsx(Heading,{level:`3`,id:`request-example`,children:`Request Example`}),`\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:`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`})}),`\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:`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. Matches score at least 50 and routinely exceed 100. `,_jsx(_components.code,{children:`null`}),` unless\n`,_jsx(_components.code,{children:`is_match`}),` is true. See `,_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`]}),`\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:`input-requirements`,children:`Input Requirements`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),`: Required - provide either (`,_jsx(_components.code,{children:`first_name`}),` AND `,_jsx(_components.code,{children:`last_name`}),`) OR `,_jsx(_components.code,{children:`full_name`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact`}),`: Required - provide at least one `,_jsx(_components.code,{children:`emails`}),` or `,_jsx(_components.code,{children:`phones`})]}),`\n`,_jsx(_components.li,{children:`Both name and contact information are required for V1 resolve`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`matching-quality`,children:`Matching Quality`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The matching algorithm uses fuzzy matching to handle variations in names and contact information`}),`\n`,_jsx(_components.li,{children:`Providing both accurate name and contact information improves match accuracy`}),`\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. 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. The example above scores `,_jsx(_components.code,{children:`110.0`}),`.`]}),`\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`,_jsx(_components.p,{children:`Practical guidance:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Every record returned with `,_jsx(_components.code,{children:`is_match: true`}),` already cleared Minerva’s internal\nmatch threshold and scores `,_jsx(_components.strong,{children:`at least 50`}),`. You don’t need your own floor\nunless you want to be stricter than Minerva.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`match_score`}),` is `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`is_match`}),` is false.`]}),`\n`,_jsx(_components.li,{children:`Scores are rounded to two decimal places.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`migration-to-v2`,children:`Migration to v2`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),` for:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Reverse lookup capabilities (email or phone only, no name required)`}),`\n`,_jsx(_components.li,{children:`LinkedIn URL in response`}),`\n`,_jsx(_components.li,{children:`Match condition filters to ensure data availability`}),`\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 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>","authMethod":"key","href":"/api-reference/resolve"}}},"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`,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?`}),` Do not use Resolve v1. Use `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),` instead. Resolve v1 is deprecated and remains available only for backward compatibility.`]}),_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 identify someone from their name and email?`}),`\n`,_jsx(_components.li,{children:`How can I deduplicate or match records?`}),`\n`,_jsx(_components.li,{children:`How do I get a unique identifier for a contact?`}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you need:`}),` Name (first + last or full name) AND contact information (email or phone).`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What you get back:`}),` Minerva PID (unique person identifier) and match confidence score.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required action:`}),` Migrate existing `,_jsx(_components.code,{children:`/v1/resolve`}),` integrations to `,_jsx(_components.code,{children:`/v2/resolve`}),` as soon as possible.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`The Resolve v1 endpoint matches person identity data (name, email, phone) to a\nunique Minerva Person ID (`,_jsx(_components.code,{children:`minerva_pid`}),`). This is typically the first step\nbefore enriching person data. The endpoint uses fuzzy matching to handle\nvariations in names and contact information. This reference remains available\nonly to support migrations from v1 to `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),`.`]}),`\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`,required:true,id:`param-record-id`,children:_jsx(_components.p,{children:`Your unique identifier for this record`})}),_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`,_jsx(Heading,{level:`3`,id:`request-example`,children:`Request Example`}),`\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:`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`})}),`\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:`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. Matches score at least 50 and routinely exceed 100. `,_jsx(_components.code,{children:`null`}),` unless\n`,_jsx(_components.code,{children:`is_match`}),` is true. See `,_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:`22`,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:`22`,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_xyz789abc\"`}),_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:` \"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:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\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:`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:` \"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:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\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:37.061415+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 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:`\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`})]}),`\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:`\"b2c3d4e5-f6a7-1234-bcde-f12345678901\"`})]}),`\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 /v1/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:`\"d4e5f6a7-b8c9-3456-def0-234567890123\"`})]}),`\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 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:`\"e5f6a7b8-c9d0-4567-ef01-345678901234\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`429`,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:`\"rate_limit_reached\"`}),_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:`\"You reached your total request-rate limit, please contact help@minerva.io for help\"`}),_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-5678-f012-456789012345\"`})]}),`\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`]}),`\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:`input-requirements`,children:`Input Requirements`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),`: Required - provide either (`,_jsx(_components.code,{children:`first_name`}),` AND `,_jsx(_components.code,{children:`last_name`}),`) OR `,_jsx(_components.code,{children:`full_name`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact`}),`: Required - provide at least one `,_jsx(_components.code,{children:`emails`}),` or `,_jsx(_components.code,{children:`phones`})]}),`\n`,_jsx(_components.li,{children:`Both name and contact information are required for V1 resolve`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`matching-quality`,children:`Matching Quality`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The matching algorithm uses fuzzy matching to handle variations in names and contact information`}),`\n`,_jsx(_components.li,{children:`Providing both accurate name and contact information improves match accuracy`}),`\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. 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. The example above scores `,_jsx(_components.code,{children:`110.0`}),`.`]}),`\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`,_jsx(_components.p,{children:`Practical guidance:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Every record returned with `,_jsx(_components.code,{children:`is_match: true`}),` already cleared Minerva’s internal\nmatch threshold and scores `,_jsx(_components.strong,{children:`at least 50`}),`. You don’t need your own floor\nunless you want to be stricter than Minerva.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`match_score`}),` is `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`is_match`}),` is false.`]}),`\n`,_jsx(_components.li,{children:`Scores are rounded to two decimal places.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`migration-to-v2`,children:`Migration to v2`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/resolve-v2`,children:`Resolve v2`}),` for:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Reverse lookup capabilities (email or phone only, no name required)`}),`\n`,_jsx(_components.li,{children:`LinkedIn URL in response`}),`\n`,_jsx(_components.li,{children:`Match condition filters to ensure data availability`}),`\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 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>","authMethod":"key","href":"/api-reference/resolve"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Quick Answer","slug":"quick-answer","depth":2,"children":[]},{"title":"Overview","slug":"overview","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 Example","slug":"request-example","depth":3,"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":"Input Requirements","slug":"input-requirements","depth":3,"children":[]},{"title":"Matching Quality","slug":"matching-quality","depth":3,"children":[]},{"title":"Interpreting match_score","slug":"interpreting-match_score","depth":3,"children":[]},{"title":"Migration to v2","slug":"migration-to-v2","depth":3,"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=\"22\">\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_xyz789abc\"\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\"> \"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>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\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\">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\"> \"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>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\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:37.061415+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 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\">\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\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\">\"b2c3d4e5-f6a7-1234-bcde-f12345678901\"\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 /v1/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\">\"d4e5f6a7-b8c9-3456-def0-234567890123\"\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 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\">\"e5f6a7b8-c9d0-4567-ef01-345678901234\"\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":"429","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\">\"rate_limit_reached\"\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\">\"You reached your total request-rate limit, please contact help@minerva.io for help\"\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-5678-f012-456789012345\"\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 v1","path":"/v1/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","required":true}],"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}]}}],"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>"]}]}}}}}},"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"}],"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)"}],"match_score":[{"type":"number","description":"Confidence score for the match, as an additive point total — not a 0-1 or 0-100 scale. Matches score at least 50 and routinely exceed 100. `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>","match_score":123,"is_resolvable_record":true,"validation_errors":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"minerva-a2a15a3a","siteName":"Minerva Documentation","title":"Resolve v1 - Minerva Documentation","contextualStarterQuestions":[{"_id":"6a9bbc45e59c9de1fa8f57b9","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"What data do I need to resolve?","status":"active","generatedBy":"contextual","path":"api-reference/resolve","createdAt":"2026-09-05T06:52:53.761Z","updatedAt":"2026-09-05T06:52:53.761Z","__v":0},{"_id":"6a9bbc45e59c9de1fa8f57b8","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"How do I match a person to get ID?","status":"active","generatedBy":"contextual","path":"api-reference/resolve","createdAt":"2026-09-05T06:52:53.761Z","updatedAt":"2026-09-05T06:52:53.761Z","__v":0},{"_id":"6a9bbc45e59c9de1fa8f57b7","deploymentId":"68ed07362d3e4d2fb94452da","questionText":"Should I use Resolve v1 or v2?","status":"active","generatedBy":"contextual","path":"api-reference/resolve","createdAt":"2026-09-05T06:52:53.761Z","updatedAt":"2026-09-05T06:52:53.761Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-05T06:52:40.615Z","originalFileLocation":"api-reference/resolve.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=\"Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\">\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 v1 - Minerva Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\">\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\">\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+v1\u0026amp;description=%3CWarning%3E**Do+not+use+Resolve+v1.**+This+endpoint+is+deprecated+and+remains+available+only+for+backward+compatibility.+Use+%5BResolve+v2%5D%28%2Fapi-reference%2Fresolve-v\u0026amp;theme=e97f3b1d1117a7b9cb640af6\u0026amp;signature=cbdc31f6307f0f6954a3b32e26996dc042ed147c4fe2064a1c5a323cee80f71d\">\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 v1 - Minerva Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minerva-a2a15a3a.mintlify.site/_mintlify/api/og/v2?division=Resolve\u0026amp;title=Resolve+v1\u0026amp;description=%3CWarning%3E**Do+not+use+Resolve+v1.**+This+endpoint+is+deprecated+and+remains+available+only+for+backward+compatibility.+Use+%5BResolve+v2%5D%28%2Fapi-reference%2Fresolve-v\u0026amp;theme=e97f3b1d1117a7b9cb640af6\u0026amp;signature=cbdc31f6307f0f6954a3b32e26996dc042ed147c4fe2064a1c5a323cee80f71d\">\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\">\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.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#webpage\",\"url\":\"https://docs.minerva.io/api-reference/resolve\",\"name\":\"Resolve v1\",\"description\":\"Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\",\"dateModified\":\"2026-09-05T06:52:40.615Z\",\"isPartOf\":{\"@id\":\"https://docs.minerva.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.minerva.io/api-reference/resolve#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.minerva.io/api-reference/resolve#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core Endpoints\",\"item\":\"https://docs.minerva.io/api-reference/resolve-v2\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resolve\",\"item\":\"https://docs.minerva.io/api-reference/resolve-v2\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Resolve v1\",\"item\":\"https://docs.minerva.io/api-reference/resolve\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.minerva.io/api-reference/resolve#apireference\",\"headline\":\"Resolve v1\",\"name\":\"Resolve v1\",\"description\":\"Do not use Resolve v1. This endpoint is deprecated and remains available only for backward compatibility. Use Resolve v2 for all identity-resolution workflows. Migrate existing v1 integrations to v2 as soon as possible.\",\"url\":\"https://docs.minerva.io/api-reference/resolve\",\"mainEntityOfPage\":{\"@id\":\"https://docs.minerva.io/api-reference/resolve#webpage\"},\"dateModified\":\"2026-09-05T06:52:40.615Z\",\"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.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","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","description":"Enhanced resolve with reverse lookup capabilities and match condition filters","href":"/api-reference/resolve-v2"},{"title":"Resolve v1","api":"POST https://api.minerva.io/v1/resolve","deprecated":true,"href":"/api-reference/resolve"}]},{"group":"Enrich","expanded":true,"pages":[{"title":"Enrich Input Rules","description":"Valid identifiers and record shapes for Enrich v2","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 v1 - 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"]}