Each entry in queries is resolved independently using the same matching
semantics as GET /v1/companies/lookup. Results are returned in the same
order as the input.
POST
/
v1
/
companies
/
lookup
/
batch
Look up multiple companies 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/company/lookup-batch","slug":"/api-reference/company/lookup-batch","pageMetadata":{"title":"Batch lookup companies","openapi":"POST /v1/companies/lookup/batch","description":"\nEach entry in `queries` is resolved independently using the same matching\nsemantics as `GET /v1/companies/lookup`. Results are returned in the same\norder as the input.","href":"/api-reference/company/lookup-batch"},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Each entry in \", _jsx(_components.code, {\n children: \"queries\"\n }), \" is resolved independently using the same matching\\nsemantics as \", _jsx(_components.code, {\n children: \"GET /v1/companies/lookup\"\n }), \". Results are returned in the same\\norder as the input.\"]\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 companies","openapi":"POST /v1/companies/lookup/batch","description":"\nEach entry in `queries` is resolved independently using the same matching\nsemantics as `GET /v1/companies/lookup`. Results are returned in the same\norder as the input.","href":"/api-reference/company/lookup-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"\nEach entry in `queries` is resolved independently using the same matching\nsemantics as `GET /v1/companies/lookup`. Results are returned in the same\norder as the input.","operationId":"post_lookup_companies_batch","parameters":[],"requestBody":"4f3ce64a-f625-471a-9c86-6ba78f870b00","responses":{"200":"a7d21eac-ae86-490c-bbc3-e689f5c0a3bc"},"summary":"Look up multiple companies in a single request (up to 50 queries).","tags":["Company"],"method":"post","type":"path","servers":["ac0c72ea-24cd-42c5-bf7e-af9869eeb624"],"security":["d3e1b4d8-8e73-42d2-8242-48f05e417bca"],"path":"/v1/companies/lookup/batch","baseUrlOptions":["https://production-api.joinrings.com"],"title":"Look up multiple companies 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","description":"Website domain to match (e.g. 'acme.com'). At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"queries.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","description":"Website domain to match (e.g. 'acme.com'). At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"queries.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].domain","typeLabel":"string | null"},"limit":{"default":5,"description":"Max results to return (default: 5, max: 20).","title":"Limit","type":"integer","uniqueKey":"queries.items.[INDEX].limit","typeLabel":"integer"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","description":"Company LinkedIn URL to match exactly. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"queries.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","description":"Company LinkedIn URL to match exactly. At least one of domain, linkedin_url, or name must be provided.","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 company must match every identifier sent. 'fallback': try one at a time — domain, then linkedin_url, then name — and return the matches of the first that finds any.","enum":["all","fallback"],"title":"Match Mode","type":"string","uniqueKey":"queries.items.[INDEX].match_mode","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Matches the company name by case-insensitive substring OR fuzzy similarity, so it catches typos and queries with an extra suffix the stored name doesn't carry (e.g. 'Acme Labs' against 'Acme'). Fuzzy matching only kicks in for queries of 3+ characters; shorter queries stay substring-only. Ranked by `similarity_score` on each match — substring hits are ranked at or above fuzzy-only ones. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"queries.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Matches the company name by case-insensitive substring OR fuzzy similarity, so it catches typos and queries with an extra suffix the stored name doesn't carry (e.g. 'Acme Labs' against 'Acme'). Fuzzy matching only kicks in for queries of 3+ characters; shorter queries stay substring-only. Ranked by `similarity_score` on each match — substring hits are ranked at or above fuzzy-only ones. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"queries.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].name","typeLabel":"string | null"}},"title":"CompanyLookupBatchItem","type":"object","uniqueKey":"queries.items.[INDEX]","typeLabel":"CompanyLookupBatchItem · object"},"maxItems":50,"title":"Queries","type":"array","isRequired":true,"uniqueKey":"queries","typeLabel":"CompanyLookupBatchItem · object[]"}},"required":["queries"],"title":"CompanyLookupBatchRequest","type":"object","uniqueKey":"","typeLabel":"CompanyLookupBatchRequest · object"},"examples":{"Example":{"title":"Example","value":{"queries":[{"domain":"\u003cstring>","limit":5,"linkedin_url":"\u003cstring>","match_mode":"all","name":"\u003cstring>"}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a7d21eac-ae86-490c-bbc3-e689f5c0a3bc":{"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":{"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"},"website":{"oneOf":[{"type":"string","title":"Website","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].website.oneOf.0","typeLabel":"string"},{"type":"null","title":"Website","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].website.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].website","typeLabel":"string | null"},"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"},"country_code":{"oneOf":[{"type":"string","title":"Country Code","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Country Code","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].country_code","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"},"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[]"},"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 company 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 company 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 company, 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 company, 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"},"rings_industry_tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].rings_industry_tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Rings Industry Tags","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].rings_industry_tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Rings Industry Tags","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].rings_industry_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].rings_industry_tags","typeLabel":"string[] | null"},"similarity_score":{"oneOf":[{"type":"number","title":"Similarity Score","description":"Name-similarity score (0.0-1.0), populated only for `name`-keyed lookups (both substring and fuzzy matches carry a real score here — it isn't gated to fuzzy-only hits). Null for domain/linkedin_url matches, which are exact. Several companies can share a similar name — use this alongside `website` and `linkedin_url` to decide whether a candidate is the same company 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 `name`-keyed lookups (both substring and fuzzy matches carry a real score here — it isn't gated to fuzzy-only hits). Null for domain/linkedin_url matches, which are exact. Several companies can share a similar name — use this alongside `website` and `linkedin_url` to decide whether a candidate is the same company 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"}},"required":["uuid","name","website","linkedin_url","last_activity_date"],"title":"CompanyLookupMatch","type":"object","uniqueKey":"results.items.[INDEX].matches.items.[INDEX]","typeLabel":"CompanyLookupMatch · object"},"title":"Matches","type":"array","isRequired":true,"uniqueKey":"results.items.[INDEX].matches","typeLabel":"CompanyLookupMatch · object[]"},"query":{"properties":{"domain":{"oneOf":[{"type":"string","title":"Domain","description":"Website domain to match (e.g. 'acme.com'). At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"results.items.[INDEX].query.domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","description":"Website domain to match (e.g. 'acme.com'). At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"results.items.[INDEX].query.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.domain","typeLabel":"string | null"},"limit":{"default":5,"description":"Max results to return (default: 5, max: 20).","title":"Limit","type":"integer","uniqueKey":"results.items.[INDEX].query.limit","typeLabel":"integer"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","description":"Company LinkedIn URL to match exactly. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"results.items.[INDEX].query.linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","description":"Company LinkedIn URL to match exactly. At least one of domain, linkedin_url, or name must be provided.","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 company must match every identifier sent. 'fallback': try one at a time — domain, then linkedin_url, then name — and return the matches of the first that finds any.","enum":["all","fallback"],"title":"Match Mode","type":"string","uniqueKey":"results.items.[INDEX].query.match_mode","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Matches the company name by case-insensitive substring OR fuzzy similarity, so it catches typos and queries with an extra suffix the stored name doesn't carry (e.g. 'Acme Labs' against 'Acme'). Fuzzy matching only kicks in for queries of 3+ characters; shorter queries stay substring-only. Ranked by `similarity_score` on each match — substring hits are ranked at or above fuzzy-only ones. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"results.items.[INDEX].query.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Matches the company name by case-insensitive substring OR fuzzy similarity, so it catches typos and queries with an extra suffix the stored name doesn't carry (e.g. 'Acme Labs' against 'Acme'). Fuzzy matching only kicks in for queries of 3+ characters; shorter queries stay substring-only. Ranked by `similarity_score` on each match — substring hits are ranked at or above fuzzy-only ones. At least one of domain, linkedin_url, or name must be provided.","uniqueKey":"results.items.[INDEX].query.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].query.name","typeLabel":"string | null"}},"title":"CompanyLookupBatchItem","type":"object","isRequired":true,"uniqueKey":"results.items.[INDEX].query","typeLabel":"CompanyLookupBatchItem · object"}},"required":["query","matches","count"],"title":"CompanyLookupBatchResult","type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"CompanyLookupBatchResult · object"},"title":"Results","type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"CompanyLookupBatchResult · object[]"}},"required":["results"],"title":"CompanyLookupBatchResponse","type":"object","uniqueKey":"","typeLabel":"CompanyLookupBatchResponse · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"count":123,"matches":[{"last_activity_date":"\u003cstring>","linkedin_url":"\u003cstring>","name":"\u003cstring>","uuid":"\u003cstring>","website":"\u003cstring>","city":"\u003cstring>","country_code":"\u003cstring>","description":"\u003cstring>","entity_lists":[{"name":"\u003cstring>","uuid":"\u003cstring>"}],"external_ids":[{"id":"\u003cstring>","source":"\u003cstring>","url":"\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>"},"rings_industry_tags":["\u003cstring>"],"similarity_score":123,"state":"\u003cstring>"}],"query":{"domain":"\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 companies - Rings AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-17T10:17:52.763Z","originalFileLocation":"api-reference/company/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 resolved independently using the same matching semantics as GET /v1/companies/lookup. Results are returned in the same order as the input.\">\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 companies - Rings AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Each entry in queries is resolved independently using the same matching semantics as GET /v1/companies/lookup. Results are returned in the same order as the input.\">\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/company/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=Company\u0026amp;title=Batch+lookup+companies\u0026amp;description=%0AEach+entry+in+%60queries%60+is+resolved+independently+using+the+same+matching%0Asemantics+as+%60GET+%2Fv1%2Fcompanies%2Flookup%60.+Results+are+returned+in+the+same%0Aorder+as+th\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=706719f200082cd1b8ee61efc5be088f74cb74469b8593916e7e84f564c8d952\">\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 companies - Rings AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Each entry in queries is resolved independently using the same matching semantics as GET /v1/companies/lookup. Results are returned in the same order as the input.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Company\u0026amp;title=Batch+lookup+companies\u0026amp;description=%0AEach+entry+in+%60queries%60+is+resolved+independently+using+the+same+matching%0Asemantics+as+%60GET+%2Fv1%2Fcompanies%2Flookup%60.+Results+are+returned+in+the+same%0Aorder+as+th\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=706719f200082cd1b8ee61efc5be088f74cb74469b8593916e7e84f564c8d952\">\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/company/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/company/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/company/lookup-batch#webpage\",\"url\":\"https://docs.rings.ai/api-reference/company/lookup-batch\",\"name\":\"Batch lookup companies\",\"description\":\"Each entry in queries is resolved independently using the same matching semantics as GET /v1/companies/lookup. Results are returned in the same order as the input.\",\"dateModified\":\"2026-07-17T10:17:52.763Z\",\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rings.ai/api-reference/company/lookup-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rings.ai/api-reference/company/lookup-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company\",\"item\":\"https://docs.rings.ai/api-reference/company/list-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batch lookup companies\",\"item\":\"https://docs.rings.ai/api-reference/company/lookup-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rings.ai/api-reference/company/lookup-batch#apireference\",\"headline\":\"Batch lookup companies\",\"name\":\"Batch lookup companies\",\"description\":\"Each entry in queries is resolved independently using the same matching semantics as GET /v1/companies/lookup. Results are returned in the same order as the input.\",\"url\":\"https://docs.rings.ai/api-reference/company/lookup-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rings.ai/api-reference/company/lookup-batch#webpage\"},\"dateModified\":\"2026-07-17T10:17:52.763Z\",\"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","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}","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}","description":"\nOnly fields provided in the request body are written; other\nattributes on the existing record are preserved. Returns 404 if the\ncompany is not visible to your tenant.","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","description":"\nReturns a paginated list of opportunities visible to the tenant ring.\n\nFilter parameters (all optional):\n- name: Case-insensitive substring match on the opportunity's own name\n- search: Search name and associated person/company names. All words must\n match, in any order; falls back to fuzzy matching when nothing does.\n Does not search the opportunity type label\n- opportunity_type_uuid: Filter by opportunity type UUID. Resolve a type\n name, including a sub-label, with GET /v1/opportunity-types\n- opportunity_stage_uuid: Filter by a single stage UUID\n- opportunity_stage_uuids: Comma-separated stage UUIDs (IN filter). Stage\n names aren't accepted; the parameter description explains how to\n resolve one, including names shared by several stages\n- owner_user_uuid: Comma-separated owner UUID(s); accepts either a user\n UUID or the person UUID shown as `owner.uuid` on a record. Returns 400\n if none of them resolve to a user in this tenant\n- include_no_owner: Widens owner_user_uuid to also match opportunities with\n no owner; no effect unless owner_user_uuid is set\n- has_owner: true for only owned opportunities, false for only unassigned\n ones; omit for both\n- intro_person_uuid: Filter by the intro person's UUID\n- related_company_uuid / related_person_uuid: parent opportunities that have a\n sub-opportunity associated with this entity\n- parent_uuid: Return only sub-opportunities of this parent UUID\n- hierarchy_type: 'PARENT' or 'CHILD' (ignored if parent_uuid is set)\n- company_uuid / person_uuid: Comma-separated UUID(s); union of opportunities\n associated with any of them\n- city / state / country: Where an associated person or company is based —\n this is how you answer \"which of my deals are in LA\". They AND together\n and must all match the same associated entity. Spell the state out\n ('Florida'), or pass a two-letter code with `country` ('FL' + 'US'); a\n code alone returns 400, since unscoped 'FL' resolves to Flintshire, GB\n- value_from / value_to, probability_from / probability_to: inclusive range filters\n- updated_after / updated_before: ISO 8601 date/datetime range on updated_at\n- source_date_from / source_date_to: ISO 8601 dates, required together\n- close_date_from / close_date_to: ISO 8601 dates, required together; opportunities\n with no close_date are excluded\n- last_activity_date_from / last_activity_date_to: ISO 8601 datetimes, required\n together\n- next_meeting_at_from / next_meeting_at_to: ISO 8601 datetimes, required\n together; an associated person or company has its next meeting in range\n- include_no_next_meeting: true for only opportunities with no meeting\n scheduled with any associated person or company; overrides\n next_meeting_at_from / next_meeting_at_to\n- days_in_stage_from / days_in_stage_to: inclusive range on days since the\n most recent stage change; either end may be omitted\n\nSort parameters:\n- sort_by: name | created_at | updated_at | value | weighted_value | probability |\n source_date | intro_date | close_date | last_activity_date | details | next_step |\n stage | owner | intro_person | days_in_stage | notes_and_files_count\n- order: asc | desc (default: asc)\n\nPagination:\n- page: Page number (default: 1)\n- per_page: Results per page (default: 10)\n\nThe response also includes `total_value`/`total_weighted_value`: sums of\n`value`/`weighted_value` across the full filtered set, not just the page.","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 companies - 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"]}