Each entry in queries is matched independently using the same semantics
as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name
match). Results are returned in the same order as the input queries.
Entries with no matching criteria return empty matches rather than an
error.
name queries are fuzzy (similarity-ranked) rather than exact, so they
can return several ranked candidates per entry — useful for deduping
name-only lists (e.g. conference rosters) where email/linkedin/domain
aren’t available. Use each candidate’s similarity_score plus
company_name/job_title/location to decide whether to treat it as a
match or create a new person.
POST
/
v1
/
persons
/
lookup
/
batch
Look up multiple persons in a single request (up to 50 queries).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rings AI","description":"Relationship intelligence for businesses that win on their networks. Build on Rings with the REST API or connect AI agents via MCP.","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec"},"favicon":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876"},"api":{"openapi":"https://production-api.joinrings.com/openapi.json"},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://www.rings.ai","label":"Website"}],"primary":{"type":"button","label":"Get Started","href":"https://joinrings.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rings-ai","hasAudioNarration":false,"actualSubdomain":"rings-ai","customDomains":["docs.rings.ai"],"gitSource":{"type":"github","owner":"rings-ai","repo":"rcp-data-pipeline","deployBranch":"main","contentDirectory":"mintlify_docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"f2baa2ef-5f3c-4fb9-b645-454aa43e6c38","liveDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae3521290bdcff7cbc3b51f","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":77},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Opportunity","count":11},{"language":"default","tag":"MCP Guide","count":11},{"language":"default","tag":"Add the connector","count":10},{"language":"default","tag":"Note","count":9},{"language":"default","tag":"Person","count":9},{"language":"default","tag":"Activity","count":8},{"language":"default","tag":"Company","count":7},{"language":"default","tag":"Task","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/person/lookup-batch","slug":"/api-reference/person/lookup-batch","pageMetadata":{"title":"Batch lookup persons","openapi":"POST /v1/persons/lookup/batch","description":"\nEach entry in `queries` is matched independently using the same semantics\nas `GET /v1/persons/lookup` (email, linkedin_url, domain, or fuzzy name\nmatch). Results are returned in the same order as the input queries.\nEntries with no matching criteria return empty matches rather than an\nerror.\n\n`name` queries are fuzzy (similarity-ranked) rather than exact, so they\ncan return several ranked candidates per entry — useful for deduping\nname-only lists (e.g. conference rosters) where email/linkedin/domain\naren't available. Use each candidate's `similarity_score` plus\n`company_name`/`job_title`/location to decide whether to treat it as a\nmatch or create a new person.","href":"/api-reference/person/lookup-batch"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Each entry in \", _jsx(_components.code, {\n children: \"queries\"\n }), \" is matched independently using the same semantics\\nas \", _jsx(_components.code, {\n children: \"GET /v1/persons/lookup\"\n }), \" (email, linkedin_url, domain, or fuzzy name\\nmatch). Results are returned in the same order as the input queries.\\nEntries with no matching criteria return empty matches rather than an\\nerror.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"name\"\n }), \" queries are fuzzy (similarity-ranked) rather than exact, so they\\ncan return several ranked candidates per entry — useful for deduping\\nname-only lists (e.g. conference rosters) where email/linkedin/domain\\naren’t available. Use each candidate’s \", _jsx(_components.code, {\n children: \"similarity_score\"\n }), \" plus\\n\", _jsx(_components.code, {\n children: \"company_name\"\n }), \"/\", _jsx(_components.code, {\n children: \"job_title\"\n }), \"/location to decide whether to treat it as a\\nmatch or create a new person.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Batch lookup persons","openapi":"POST /v1/persons/lookup/batch","description":"\nEach entry in `queries` is matched independently using the same semantics\nas `GET /v1/persons/lookup` (email, linkedin_url, domain, or fuzzy name\nmatch). Results are returned in the same order as the input queries.\nEntries with no matching criteria return empty matches rather than an\nerror.\n\n`name` queries are fuzzy (similarity-ranked) rather than exact, so they\ncan return several ranked candidates per entry — useful for deduping\nname-only lists (e.g. conference rosters) where email/linkedin/domain\naren't available. Use each candidate's `similarity_score` plus\n`company_name`/`job_title`/location to decide whether to treat it as a\nmatch or create a new person.","href":"/api-reference/person/lookup-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"\nEach entry in `queries` is matched independently using the same semantics\nas `GET /v1/persons/lookup` (email, linkedin_url, domain, or fuzzy name\nmatch). Results are returned in the same order as the input queries.\nEntries with no matching criteria return empty matches rather than an\nerror.\n\n`name` queries are fuzzy (similarity-ranked) rather than exact, so they\ncan return several ranked candidates per entry — useful for deduping\nname-only lists (e.g. conference rosters) where email/linkedin/domain\naren't available. Use each candidate's `similarity_score` plus\n`company_name`/`job_title`/location to decide whether to treat it as a\nmatch or create a new person.","operationId":"post_lookup_persons_batch","parameters":[],"requestBody":"df5c3957-5241-4971-87db-57a406464a4c","responses":{"200":"ce943ed7-d3fd-465f-9c1f-93002624ef35"},"summary":"Look up multiple persons in a single request (up to 50 queries).","tags":["Person"],"method":"post","type":"path","servers":["ac0c72ea-24cd-42c5-bf7e-af9869eeb624"],"security":["d3e1b4d8-8e73-42d2-8242-48f05e417bca"],"path":"/v1/persons/lookup/batch","baseUrlOptions":["https://production-api.joinrings.com"],"title":"Look up multiple persons in a single request (up to 50 queries).","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"queries":{"description":"Lookups to run, max 50 per call. Split longer lists into several calls.","items":{"properties":{"domain":{"oneOf":[{"type":"string","title":"Domain","uniqueKey":"queries.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","uniqueKey":"queries.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].domain","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","uniqueKey":"queries.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","uniqueKey":"queries.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].email","typeLabel":"string | null"},"limit":{"default":5,"title":"Limit","type":"integer","uniqueKey":"queries.items.[INDEX].limit","typeLabel":"integer"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"queries.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"queries.items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].linkedin_url","typeLabel":"string | null"},"match_mode":{"default":"all","description":"How several identifiers combine. 'all' (default): a person must match every identifier sent. 'fallback': try one at a time — email, then linkedin_url, then name (narrowed by domain when both are sent) — and return the matches of the first that finds any. In 'fallback', domain on its own is used only when it is the only identifier sent.","enum":["all","fallback"],"title":"Match Mode","type":"string","uniqueKey":"queries.items.[INDEX].match_mode","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"queries.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"queries.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].name","typeLabel":"string | null"}},"title":"PersonLookupBatchItem","type":"object","uniqueKey":"queries.items.[INDEX]","typeLabel":"PersonLookupBatchItem · object"},"maxItems":50,"title":"Queries","type":"array","isRequired":true,"uniqueKey":"queries","typeLabel":"PersonLookupBatchItem · object[]"}},"required":["queries"],"title":"PersonLookupBatchRequest","type":"object","uniqueKey":"","typeLabel":"PersonLookupBatchRequest · object"},"examples":{"Example":{"title":"Example","value":{"queries":[{"domain":"\u003cstring>","email":"\u003cstring>","limit":5,"linkedin_url":"\u003cstring>","match_mode":"all","name":"\u003cstring>"}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"ce943ed7-d3fd-465f-9c1f-93002624ef35":{"content":{"application/json":{"schema":{"properties":{"results":{"items":{"properties":{"count":{"title":"Count","type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].count","typeLabel":"integer"},"matches":{"items":{"properties":{"email":{"oneOf":[{"type":"string","title":"Email","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email","typeLabel":"string | null"},"last_activity_date":{"oneOf":[{"type":"string","title":"Last Activity Date","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_activity_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Activity Date","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_activity_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_activity_date","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name","typeLabel":"string | null"},"uuid":{"title":"Uuid","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].uuid","typeLabel":"string"},"city":{"oneOf":[{"type":"string","title":"City","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].city","typeLabel":"string | null"},"company_name":{"oneOf":[{"type":"string","title":"Company Name","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company Name","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_name","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","title":"Country","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","title":"Country","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country","typeLabel":"string | null"},"current_company":{"oneOf":[{"type":"object","title":"CurrentCompany","required":["uuid","company_name","logo_url"],"properties":{"company_name":{"oneOf":[{"type":"string","title":"Company Name","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.company_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company Name","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.company_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.company_name","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","title":"Logo Url","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Logo Url","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.logo_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.logo_url","typeLabel":"string | null"},"uuid":{"oneOf":[{"type":"string","title":"Uuid","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Uuid","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.uuid.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.uuid","typeLabel":"string | null"},"job_type":{"oneOf":[{"type":"string","title":"Job Type","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.job_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Type","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.job_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.job_type","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","title":"Source","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.source.oneOf.0","typeLabel":"string"},{"type":"null","title":"Source","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.source.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0.source","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.0","typeLabel":"CurrentCompany · object"},{"type":"null","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company","typeLabel":"CurrentCompany · object | null"},"current_company_domain":{"oneOf":[{"type":"string","title":"Current Company Domain","description":"Domain of the company the person currently works at.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Current Company Domain","description":"Domain of the company the person currently works at.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_domain","typeLabel":"string | null"},"current_company_name":{"oneOf":[{"type":"string","title":"Current Company Name","description":"Name of the company the person currently works at.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Current Company Name","description":"Name of the company the person currently works at.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_company_name","typeLabel":"string | null"},"current_job_title":{"oneOf":[{"type":"string","title":"Current Job Title","description":"Current job title, from the person's enriched employment history.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_job_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Current Job Title","description":"Current job title, from the person's enriched employment history.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_job_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].current_job_title","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].description","typeLabel":"string | null"},"email_last_seen":{"oneOf":[{"type":"string","title":"Email Last Seen","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email_last_seen.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email Last Seen","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email_last_seen.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].email_last_seen","typeLabel":"string | null"},"entity_lists":{"oneOf":[{"type":"array","items":{"properties":{"name":{"title":"Name","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists.oneOf.0.items.[INDEX].name","typeLabel":"string"},"uuid":{"title":"Uuid","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists.oneOf.0.items.[INDEX].uuid","typeLabel":"string"}},"required":["uuid","name"],"title":"EntityListMembership","type":"object","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists.oneOf.0.items.[INDEX]","typeLabel":"EntityListMembership · object"},"title":"Entity Lists","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists.oneOf.0","typeLabel":"EntityListMembership · object[]"},{"type":"null","title":"Entity Lists","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].entity_lists","typeLabel":"EntityListMembership · object[] | null"},"external_ids":{"description":"Ids for this record at external data providers, one entry per provider. Empty when none are known.","items":{"properties":{"id":{"description":"The record's id at that provider. For Crunchbase, the organization or person UUID.","title":"Id","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX].id","typeLabel":"string"},"source":{"description":"Provider the id belongs to. Currently 'crunchbase'.","title":"Source","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","title":"Url","description":"Link to the record at that provider, when known. Null for Crunchbase companies, which have no stored link.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"Link to the record at that provider, when known. Null for Crunchbase companies, which have no stored link.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX].url","typeLabel":"string | null"}},"required":["source","id"],"title":"ExternalId","type":"object","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids.items.[INDEX]","typeLabel":"ExternalId · object"},"title":"External Ids","type":"array","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].external_ids","typeLabel":"ExternalId · object[]"},"is_primary_company_recommended":{"oneOf":[{"type":"boolean","title":"Is Primary Company Recommended","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].is_primary_company_recommended.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Primary Company Recommended","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].is_primary_company_recommended.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].is_primary_company_recommended","typeLabel":"boolean | null"},"job_changed_at":{"oneOf":[{"type":"string","title":"Job Changed At","description":"ISO 8601 timestamp of when the person moved into their current role.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_changed_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Changed At","description":"ISO 8601 timestamp of when the person moved into their current role.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_changed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_changed_at","typeLabel":"string | null"},"job_title":{"oneOf":[{"type":"string","title":"Job Title","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Title","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].job_title","typeLabel":"string | null"},"last_contact_at":{"oneOf":[{"type":"string","title":"Last Contact At","description":"Most recent tenant-wide contact timestamp, aggregated across all activity types. Alias of `last_activity_date` — both fields always hold the same value.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_contact_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Contact At","description":"Most recent tenant-wide contact timestamp, aggregated across all activity types. Alias of `last_activity_date` — both fields always hold the same value.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_contact_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].last_contact_at","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","title":"Logo Url","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Logo Url","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].logo_url","typeLabel":"string | null"},"my_next_meeting_at":{"oneOf":[{"type":"string","title":"My Next Meeting At","description":"ISO 8601 timestamp of the earliest future calendar event involving this person where the calling user (x-rings-user-id) is a participant. null when no user context is provided.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"My Next Meeting At","description":"ISO 8601 timestamp of the earliest future calendar event involving this person where the calling user (x-rings-user-id) is a participant. null when no user context is provided.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_at","typeLabel":"string | null"},"my_next_meeting_title":{"oneOf":[{"type":"string","title":"My Next Meeting Title","description":"Title of the per-user next meeting. null when no user context is provided.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"My Next Meeting Title","description":"Title of the per-user next meeting. null when no user context is provided.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].my_next_meeting_title","typeLabel":"string | null"},"next_meeting_at":{"oneOf":[{"type":"string","title":"Next Meeting At","description":"ISO 8601 timestamp of the earliest future calendar event involving this person, tenant-wide. Cancelled and deleted events are excluded. Updates as calendar changes arrive, with an hourly reconciliation pass.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Meeting At","description":"ISO 8601 timestamp of the earliest future calendar event involving this person, tenant-wide. Cancelled and deleted events are excluded. Updates as calendar changes arrive, with an hourly reconciliation pass.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_at","typeLabel":"string | null"},"next_meeting_title":{"oneOf":[{"type":"string","title":"Next Meeting Title","description":"Title of the tenant-wide next meeting.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Meeting Title","description":"Title of the tenant-wide next meeting.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_title","typeLabel":"string | null"},"next_meeting_with_user_uuid":{"oneOf":[{"type":"string","title":"Next Meeting With User Uuid","description":"UUID of the internal ring member attending the tenant-wide next meeting (prefers the organizer).","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_with_user_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Meeting With User Uuid","description":"UUID of the internal ring member attending the tenant-wide next meeting (prefers the organizer).","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_with_user_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].next_meeting_with_user_uuid","typeLabel":"string | null"},"pathpower":{"oneOf":[{"type":"object","title":"PathPowerMetrics","properties":{"meta":{"oneOf":[{"type":"object","title":"Meta","additionalProperties":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.meta.oneOf.0","typeLabel":"Meta · object"},{"type":"null","title":"Meta","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.meta","typeLabel":"Meta · object | null"},"score":{"oneOf":[{"type":"number","title":"Score","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Score","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.score","typeLabel":"number | null"},"strength_label":{"oneOf":[{"type":"string","title":"Strength Label","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.strength_label.oneOf.0","typeLabel":"string"},{"type":"null","title":"Strength Label","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.strength_label.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0.strength_label","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.0","typeLabel":"PathPowerMetrics · object"},{"type":"null","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].pathpower","typeLabel":"PathPowerMetrics · object | null"},"previous_job_ended_at":{"oneOf":[{"type":"string","title":"Previous Job Ended At","description":"ISO 8601 timestamp of when the person's most recent previous job ended.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].previous_job_ended_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Previous Job Ended At","description":"ISO 8601 timestamp of when the person's most recent previous job ended.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].previous_job_ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].previous_job_ended_at","typeLabel":"string | null"},"secondary_email":{"oneOf":[{"type":"string","title":"Secondary Email","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Secondary Email","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email","typeLabel":"string | null"},"secondary_email_last_seen":{"oneOf":[{"type":"string","title":"Secondary Email Last Seen","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email_last_seen.oneOf.0","typeLabel":"string"},{"type":"null","title":"Secondary Email Last Seen","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email_last_seen.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].secondary_email_last_seen","typeLabel":"string | null"},"similarity_score":{"oneOf":[{"type":"number","title":"Similarity Score","description":"Name-similarity score (0.0-1.0), populated only for fuzzy `name`-keyed lookups. Null for email/linkedin/domain matches, which are exact. Several people can share a similar name — use this alongside `company_name`, `job_title`, and `city`/`state`/`country` to decide whether a candidate is the same person before creating a new record.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].similarity_score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Similarity Score","description":"Name-similarity score (0.0-1.0), populated only for fuzzy `name`-keyed lookups. Null for email/linkedin/domain matches, which are exact. Several people can share a similar name — use this alongside `company_name`, `job_title`, and `city`/`state`/`country` to decide whether a candidate is the same person before creating a new record.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].similarity_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].similarity_score","typeLabel":"number | null"},"state":{"oneOf":[{"type":"string","title":"State","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].state.oneOf.0","typeLabel":"string"},{"type":"null","title":"State","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].state.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].state","typeLabel":"string | null"},"strongest_relationships":{"oneOf":[{"type":"array","items":{"properties":{"internal_user_person_uuid":{"oneOf":[{"type":"string","title":"Internal User Person Uuid","description":"Person UUID for the internal user, usable as the `{uuid}` path parameter on other person endpoints.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_person_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Internal User Person Uuid","description":"Person UUID for the internal user, usable as the `{uuid}` path parameter on other person endpoints.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_person_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_person_uuid","typeLabel":"string | null"},"internal_user_uuid":{"oneOf":[{"type":"string","title":"Internal User Uuid","description":"UUID of the internal ring member.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Internal User Uuid","description":"UUID of the internal ring member.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].internal_user_uuid","typeLabel":"string | null"},"last_engaged_at":{"oneOf":[{"type":"string","title":"Last Engaged At","description":"ISO 8601 timestamp of the most recent all-time activity between this internal user and the subject entity. May lag the most recent activity by up to a refresh interval.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].last_engaged_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Engaged At","description":"ISO 8601 timestamp of the most recent all-time activity between this internal user and the subject entity. May lag the most recent activity by up to a refresh interval.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].last_engaged_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].last_engaged_at","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Display name of the internal user.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Display name of the internal user.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"path_power_score":{"oneOf":[{"type":"number","title":"Path Power Score","description":"Strength of the relationship, sourced from `priority_management.rq_pretty`. Higher is stronger. The existing `pathpower.score` field remains the preferred numeric score for the person/company itself; this field reflects the specific internal user's relationship.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].path_power_score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Path Power Score","description":"Strength of the relationship, sourced from `priority_management.rq_pretty`. Higher is stronger. The existing `pathpower.score` field remains the preferred numeric score for the person/company itself; this field reflects the specific internal user's relationship.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].path_power_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX].path_power_score","typeLabel":"number | null"}},"title":"StrongestRelationship","type":"object","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0.items.[INDEX]","typeLabel":"StrongestRelationship · object"},"title":"Strongest Relationships","description":"Up to two tenant internal users with the strongest relationship to this person, ranked by `priority_management.rq_pretty` (desc). Refreshed about every 3 hours; `null` when no qualifying signals exist.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.0","typeLabel":"StrongestRelationship · object[]"},{"type":"null","title":"Strongest Relationships","description":"Up to two tenant internal users with the strongest relationship to this person, ranked by `priority_management.rq_pretty` (desc). Refreshed about every 3 hours; `null` when no qualifying signals exist.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].strongest_relationships","typeLabel":"StrongestRelationship · object[] | null"}},"required":["uuid","name","email","linkedin_url","last_activity_date"],"title":"PersonLookupMatch","type":"object","uniqueKey":"results.items.[INDEX].matches.items.[INDEX]","typeLabel":"PersonLookupMatch · object"},"title":"Matches","type":"array","isRequired":true,"uniqueKey":"results.items.[INDEX].matches","typeLabel":"PersonLookupMatch · object[]"},"query":{"properties":{"domain":{"oneOf":[{"type":"string","title":"Domain","uniqueKey":"results.items.[INDEX].query.domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","uniqueKey":"results.items.[INDEX].query.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.domain","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","uniqueKey":"results.items.[INDEX].query.email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","uniqueKey":"results.items.[INDEX].query.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.email","typeLabel":"string | null"},"limit":{"default":5,"title":"Limit","type":"integer","uniqueKey":"results.items.[INDEX].query.limit","typeLabel":"integer"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].query.linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].query.linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.linkedin_url","typeLabel":"string | null"},"match_mode":{"default":"all","description":"How several identifiers combine. 'all' (default): a person must match every identifier sent. 'fallback': try one at a time — email, then linkedin_url, then name (narrowed by domain when both are sent) — and return the matches of the first that finds any. In 'fallback', domain on its own is used only when it is the only identifier sent.","enum":["all","fallback"],"title":"Match Mode","type":"string","uniqueKey":"results.items.[INDEX].query.match_mode","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].query.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].query.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.name","typeLabel":"string | null"}},"title":"PersonLookupBatchItem","type":"object","isRequired":true,"uniqueKey":"results.items.[INDEX].query","typeLabel":"PersonLookupBatchItem · object"}},"required":["query","matches","count"],"title":"PersonLookupBatchResult","type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"PersonLookupBatchResult · object"},"title":"Results","type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"PersonLookupBatchResult · object[]"}},"required":["results"],"title":"PersonLookupBatchResponse","type":"object","uniqueKey":"","typeLabel":"PersonLookupBatchResponse · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"count":123,"matches":[{"email":"\u003cstring>","last_activity_date":"\u003cstring>","linkedin_url":"\u003cstring>","name":"\u003cstring>","uuid":"\u003cstring>","city":"\u003cstring>","company_name":"\u003cstring>","country":"\u003cstring>","current_company":{"company_name":"\u003cstring>","logo_url":"\u003cstring>","uuid":"\u003cstring>","job_type":"\u003cstring>","source":"\u003cstring>"},"current_company_domain":"\u003cstring>","current_company_name":"\u003cstring>","current_job_title":"\u003cstring>","description":"\u003cstring>","email_last_seen":"\u003cstring>","entity_lists":[{"name":"\u003cstring>","uuid":"\u003cstring>"}],"external_ids":[{"id":"\u003cstring>","source":"\u003cstring>","url":"\u003cstring>"}],"is_primary_company_recommended":true,"job_changed_at":"\u003cstring>","job_title":"\u003cstring>","last_contact_at":"\u003cstring>","logo_url":"\u003cstring>","my_next_meeting_at":"\u003cstring>","my_next_meeting_title":"\u003cstring>","next_meeting_at":"\u003cstring>","next_meeting_title":"\u003cstring>","next_meeting_with_user_uuid":"\u003cstring>","pathpower":{"meta":{},"score":123,"strength_label":"\u003cstring>"},"previous_job_ended_at":"\u003cstring>","secondary_email":"\u003cstring>","secondary_email_last_seen":"\u003cstring>","similarity_score":123,"state":"\u003cstring>","strongest_relationships":[{"internal_user_person_uuid":"\u003cstring>","internal_user_uuid":"\u003cstring>","last_engaged_at":"\u003cstring>","name":"\u003cstring>","path_power_score":123}]}],"query":{"domain":"\u003cstring>","email":"\u003cstring>","limit":5,"linkedin_url":"\u003cstring>","match_mode":"all","name":"\u003cstring>"}}]}}},"exampleType":"generated"}},"description":"Batch lookup response, ordered to match the input `queries`.","exampleType":"generated"}},"security":{"d3e1b4d8-8e73-42d2-8242-48f05e417bca":{"ApiKeyAuth":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"ac0c72ea-24cd-42c5-bf7e-af9869eeb624":{"description":"API server","url":"https://production-api.joinrings.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://production-api.joinrings.com/openapi.json"},"subdomain":"rings-ai","siteName":"Rings AI","title":"Batch lookup persons - Rings AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T14:32:27.067Z","originalFileLocation":"api-reference/person/lookup-batch.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=\"dark\"}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=\"Each entry in queries is matched independently using the same semantics as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name match). Results are returned in the same order as the input queries. Entries with no matching criteria return empty matches rather than an error. name queries are fuzzy (similarity-ranked) rather than exact, so they can return several ranked candidates per entry — useful for deduping name-only lists (e.g. conference rosters) where email/linkedin/domain aren\u0026#x27;t available. Use each candidate\u0026#x27;s similarity_score plus company_name/job_title/location to decide whether to treat it as a match or create a new person.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Batch lookup persons - Rings AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Each entry in queries is matched independently using the same semantics as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name match). Results are returned in the same order as the input queries. Entries with no matching criteria return empty matches rather than an error. name queries are fuzzy (similarity-ranked) rather than exact, so they can return several ranked candidates per entry — useful for deduping name-only lists (e.g. conference rosters) where email/linkedin/domain aren\u0026#x27;t available. Use each candidate\u0026#x27;s similarity_score plus company_name/job_title/location to decide whether to treat it as a match or create a new person.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rings AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rings.ai/api-reference/person/lookup-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Person\u0026amp;title=Batch+lookup+persons\u0026amp;description=%0AEach+entry+in+%60queries%60+is+matched+independently+using+the+same+semantics%0Aas+%60GET+%2Fv1%2Fpersons%2Flookup%60+%28email%2C+linkedin_url%2C+domain%2C+or+fuzzy+name%0Amatch%29.+Resul\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=dd57aa49c9cc9870fe2081717b118f88da5d07a1c8495cdce5b98ae5c143c43f\">\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=\"Batch lookup persons - Rings AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Each entry in queries is matched independently using the same semantics as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name match). Results are returned in the same order as the input queries. Entries with no matching criteria return empty matches rather than an error. name queries are fuzzy (similarity-ranked) rather than exact, so they can return several ranked candidates per entry — useful for deduping name-only lists (e.g. conference rosters) where email/linkedin/domain aren\u0026#x27;t available. Use each candidate\u0026#x27;s similarity_score plus company_name/job_title/location to decide whether to treat it as a match or create a new person.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Person\u0026amp;title=Batch+lookup+persons\u0026amp;description=%0AEach+entry+in+%60queries%60+is+matched+independently+using+the+same+semantics%0Aas+%60GET+%2Fv1%2Fpersons%2Flookup%60+%28email%2C+linkedin_url%2C+domain%2C+or+fuzzy+name%0Amatch%29.+Resul\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=dd57aa49c9cc9870fe2081717b118f88da5d07a1c8495cdce5b98ae5c143c43f\">\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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rings.ai/api-reference/person/lookup-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/person/lookup-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rings.ai/#organization\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rings.ai#website\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rings.ai/api-reference/person/lookup-batch#webpage\",\"url\":\"https://docs.rings.ai/api-reference/person/lookup-batch\",\"name\":\"Batch lookup persons\",\"description\":\"Each entry in queries is matched independently using the same semantics as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name match). Results are returned in the same order as the input queries. Entries with no matching criteria return empty matches rather than an error. name queries are fuzzy (similarity-ranked) rather than exact, so they can return several ranked candidates per entry — useful for deduping name-only lists (e.g. conference rosters) where email/linkedin/domain aren't available. Use each candidate's similarity_score plus company_name/job_title/location to decide whether to treat it as a match or create a new person.\",\"dateModified\":\"2026-09-29T14:32:27.067Z\",\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rings.ai/api-reference/person/lookup-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rings.ai/api-reference/person/lookup-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Person\",\"item\":\"https://docs.rings.ai/api-reference/person/list-persons\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batch lookup persons\",\"item\":\"https://docs.rings.ai/api-reference/person/lookup-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rings.ai/api-reference/person/lookup-batch#apireference\",\"headline\":\"Batch lookup persons\",\"name\":\"Batch lookup persons\",\"description\":\"Each entry in queries is matched independently using the same semantics as GET /v1/persons/lookup (email, linkedin_url, domain, or fuzzy name match). Results are returned in the same order as the input queries. Entries with no matching criteria return empty matches rather than an error. name queries are fuzzy (similarity-ranked) rather than exact, so they can return several ranked candidates per entry — useful for deduping name-only lists (e.g. conference rosters) where email/linkedin/domain aren't available. Use each candidate's similarity_score plus company_name/job_title/location to decide whether to treat it as a match or create a new person.\",\"url\":\"https://docs.rings.ai/api-reference/person/lookup-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rings.ai/api-reference/person/lookup-batch#webpage\"},\"dateModified\":\"2026-09-29T14:32:27.067Z\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rings AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rings AI","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Person","pages":[{"title":"List persons","openapi":"GET /v1/persons","href":"/api-reference/person/list-persons"},{"title":"List person custom fields","openapi":"GET /v1/persons/custom-fields","href":"/api-reference/person/list-custom-fields"},{"title":"Create a person","openapi":"POST /v1/persons","href":"/api-reference/person/create-person"},{"title":"Batch create persons","openapi":"POST /v1/persons/batch","href":"/api-reference/person/batch-create"},{"title":"Lookup a person","openapi":"GET /v1/persons/lookup","description":"\nSearches across tenant-visible persons (including global records). At least\none of email, linkedin_url, domain, or name must be provided. Returns up to\n`limit` matches (default 5, max 20), ranked so tenant-specific records\nappear before global ones.\n\nParameters:\n- email: Matches any of the person's emails (case/whitespace-insensitive)\n- linkedin_url: LinkedIn profile URL (e.g. 'https://linkedin.com/in/johndoe')\n- domain: Email domain to match — e.g. 'acme.com' matches 'alice@acme.com'\n- name: Fuzzy (similarity-ranked) match on display name, e.g. for deduping\n name-only lists such as conference rosters. Unlike the other criteria this\n is not an exact key — several people can match. Results are ranked by\n `similarity_score`; use it alongside `company_name`/`job_title`/location to\n decide whether a candidate is the same person before creating a new record.\n- limit: Max results to return (default: 5, max: 20)","href":"/api-reference/person/lookup"},{"title":"Batch lookup persons","openapi":"POST /v1/persons/lookup/batch","href":"/api-reference/person/lookup-batch"},{"title":"Get a person","openapi":"GET /v1/persons/{person_uuid}","description":"\nReturns the full person record including:\n- strongest_relationships: top 2 internal team members with the strongest\n connection to this person (use for \"who internally knows X\" without needing\n recommended-paths)\n- pathpower: overall relationship strength score (0.0–1.0)\n- priority_management.rq: the canonical relationship quality score (1–3,\n null when no signal exists). Ignore rq_manual and rq_math — use rq as\n the single source of truth.\n- Secondary emails, phone numbers, entity list memberships, company affiliation.\n\nReturns 404 if the person is not visible to your tenant.","href":"/api-reference/person/get-person"},{"title":"Update a person","openapi":"PUT /v1/persons/{person_uuid}","href":"/api-reference/person/update-person"},{"title":"Merge persons","openapi":"POST /v1/persons/{person_uuid}/merge","href":"/api-reference/person/merge-person"}]},{"group":"Company","pages":[{"title":"List companies","openapi":"GET /v1/companies","href":"/api-reference/company/list-companies"},{"title":"Create a company","openapi":"POST /v1/companies","href":"/api-reference/company/create-company"},{"title":"Lookup a company","openapi":"GET /v1/companies/lookup","href":"/api-reference/company/lookup"},{"title":"Get a company","openapi":"GET /v1/companies/{company_uuid}","href":"/api-reference/company/get-company"},{"title":"List company employees","openapi":"GET /v1/companies/{company_uuid}/employees","href":"/api-reference/company/list-employees"},{"title":"Update a company","openapi":"PUT /v1/companies/{company_uuid}","href":"/api-reference/company/update-company"},{"title":"Batch lookup companies","openapi":"POST /v1/companies/lookup/batch","href":"/api-reference/company/lookup-batch"}]},{"group":"Opportunity","pages":[{"title":"List opportunities","openapi":"GET /v1/opportunities","href":"/api-reference/opportunity/list-opportunities"},{"title":"Create an opportunity","openapi":"POST /v1/opportunities","href":"/api-reference/opportunity/create-opportunity"},{"title":"Get an opportunity","openapi":"GET /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/get-opportunity"},{"title":"Update an opportunity","openapi":"PUT /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/update-opportunity"},{"title":"Delete opportunities","openapi":"DELETE /v1/opportunities","href":"/api-reference/opportunity/delete-opportunities"},{"title":"Add opportunity association","openapi":"POST /v1/opportunities/{opportunity_uuid}/associations","href":"/api-reference/opportunity/add-association"},{"title":"Delete opportunity association","openapi":"DELETE /v1/opportunities/{opportunity_uuid}/associations/{association_uuid}","href":"/api-reference/opportunity/delete-association"},{"title":"List opportunity types","openapi":"GET /v1/opportunity-types","href":"/api-reference/opportunity/list-types"},{"title":"List opportunity stages","openapi":"GET /v1/opportunity-types/{type_uuid}/stages","href":"/api-reference/opportunity/list-stages"},{"title":"List opportunities for a company","openapi":"GET /v1/companies/{company_uuid}/opportunities","href":"/api-reference/opportunity/list-by-company"},{"title":"List opportunities for a person","openapi":"GET /v1/persons/{person_uuid}/opportunities","href":"/api-reference/opportunity/list-by-person"}]},{"group":"Activity","pages":[{"title":"Get activity body","openapi":"GET /v1/activities/{activity_object_id}/body","href":"/api-reference/activity/get-body"},{"title":"Get activity thread","openapi":"GET /v1/activities/{activity_object_id}/thread","href":"/api-reference/activity/get-thread"},{"title":"Company activities","openapi":"GET /v1/companies/{company_uuid}/activities","href":"/api-reference/activity/company-activities"},{"title":"Company activity stats","openapi":"GET /v1/companies/{company_uuid}/activity-stats","href":"/api-reference/activity/company-activity-stats"},{"title":"Bulk company activity stats","openapi":"POST /v1/companies/activity-stats/batch","href":"/api-reference/activity/company-activity-stats-batch"},{"title":"Person activities","openapi":"GET /v1/persons/{person_uuid}/activities","href":"/api-reference/activity/person-activities"},{"title":"Person activity stats","openapi":"GET /v1/persons/{person_uuid}/activity-stats","href":"/api-reference/activity/person-activity-stats"},{"title":"Bulk person activity stats","openapi":"POST /v1/persons/activity-stats/batch","href":"/api-reference/activity/person-activity-stats-batch"}]},{"group":"Meetings","pages":[{"title":"List meetings","openapi":"GET /v1/meetings","href":"/api-reference/meetings/list-meetings"},{"title":"Get a meeting","openapi":"GET /v1/meetings/{activity_id}","href":"/api-reference/meetings/get-meeting"}]},{"group":"Note","pages":[{"title":"List notes","openapi":"GET /v1/notes","href":"/api-reference/note/list-notes"},{"title":"Create a note","openapi":"POST /v1/notes","href":"/api-reference/note/create-note"},{"title":"Batch create notes","openapi":"POST /v1/notes/batch","href":"/api-reference/note/batch-create"},{"title":"Search notes","openapi":"POST /v1/notes/search","href":"/api-reference/note/search"},{"title":"Get a note","openapi":"GET /v1/notes/{note_uuid}","href":"/api-reference/note/get-note"},{"title":"Update a note","openapi":"PUT /v1/notes/{note_uuid}","href":"/api-reference/note/update-note"},{"title":"Delete a note","openapi":"DELETE /v1/notes/{note_uuid}","href":"/api-reference/note/delete-note"},{"title":"Add note association","openapi":"POST /v1/notes/{note_uuid}/associations","href":"/api-reference/note/add-association"},{"title":"Delete note association","openapi":"DELETE /v1/notes/{note_uuid}/associations/{association_uuid}","href":"/api-reference/note/delete-association"}]},{"group":"Task","pages":[{"title":"List tasks","openapi":"GET /v1/tasks","href":"/api-reference/task/list-tasks"},{"title":"Create a task","openapi":"POST /v1/tasks","href":"/api-reference/task/create-task"},{"title":"Get a task","openapi":"GET /v1/tasks/{task_id}","href":"/api-reference/task/get-task"},{"title":"Update a task","openapi":"PUT /v1/tasks/{task_id}","href":"/api-reference/task/update-task"},{"title":"Delete a task","openapi":"DELETE /v1/tasks/{task_id}","href":"/api-reference/task/delete-task"},{"title":"Add task association","openapi":"POST /v1/tasks/{task_id}/associations","href":"/api-reference/task/add-association"},{"title":"Delete task association","openapi":"DELETE /v1/tasks/{task_id}/associations/{association_uuid}","href":"/api-reference/task/delete-association"}]},{"group":"Recommended Paths","pages":[{"title":"Recommended paths to a person","openapi":"GET /v1/persons/{person_uuid}/recommended-paths","href":"/api-reference/recommended-paths/person"},{"title":"Recommended paths to a company","openapi":"GET /v1/companies/{company_uuid}/recommended-paths","href":"/api-reference/recommended-paths/company"},{"title":"Bulk recommended paths (persons)","openapi":"POST /v1/persons/recommended-paths/batch","href":"/api-reference/recommended-paths/person-batch"},{"title":"Bulk recommended paths (companies)","openapi":"POST /v1/companies/recommended-paths/batch","href":"/api-reference/recommended-paths/company-batch"}]},{"group":"PathPower","pages":[{"title":"Bulk PathPower scores","openapi":"GET /v1/pathpower/scores","href":"/api-reference/pathpower/bulk-scores"},{"title":"PathPower for a person","openapi":"GET /v1/persons/{person_uuid}/pathpower","href":"/api-reference/pathpower/person"},{"title":"PathPower for a company","openapi":"GET /v1/companies/{company_uuid}/pathpower","href":"/api-reference/pathpower/company"}]},{"group":"Relationships","pages":[{"title":"List ring relationships","openapi":"GET /v1/relationships","href":"/api-reference/relationships/ring"},{"title":"My relationships","openapi":"GET /v1/relationships/mine","href":"/api-reference/relationships/mine"}]},{"group":"Intro","pages":[{"title":"List intros","openapi":"GET /v1/intros","href":"/api-reference/intro/list-intros"},{"title":"Log intro","openapi":"POST /v1/intros","href":"/api-reference/intro/log-intro"},{"title":"Update intro","openapi":"PUT /v1/intros/{intro_uuid}","href":"/api-reference/intro/update-intro"},{"title":"Delete intro","openapi":"DELETE /v1/intros/{intro_uuid}","href":"/api-reference/intro/delete-intro"},{"title":"List intro options","openapi":"GET /v1/intros/options","href":"/api-reference/intro/list-options"},{"title":"Get intro insights","openapi":"GET /v1/intros/insights","href":"/api-reference/intro/insights"}]},{"group":"AI Summary","pages":[{"title":"AI summary for a person","openapi":"GET /v1/persons/{person_uuid}/ai-summary","href":"/api-reference/ai-summary/person"},{"title":"AI summary for a company","openapi":"GET /v1/companies/{company_uuid}/ai-summary","href":"/api-reference/ai-summary/company"}]},{"group":"Entity Lists","pages":[{"title":"List entity lists","openapi":"GET /v1/lists","href":"/api-reference/lists/list-lists"},{"title":"List entity list members","openapi":"GET /v1/lists/{list_uuid}/entities","href":"/api-reference/lists/list-entities"},{"title":"Create an entity list","openapi":"POST /v1/lists","href":"/api-reference/lists/create-list"},{"title":"Update an entity list","openapi":"PUT /v1/lists/{list_uuid}","href":"/api-reference/lists/update-list"}]},{"group":"Users","pages":[{"title":"Get current user","openapi":"GET /v1/me","href":"/api-reference/users/me"},{"title":"List users","openapi":"GET /v1/users","href":"/api-reference/users/list-users"}]}]}]},"title":"Batch lookup persons - Rings AI","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}