Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged.
No API key yet?Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint.
Each item may carry any combination of identifiers:
domain → exact match on any of the company’s domains. Returns all matching records.
linkedin_url → exact match on the company’s LinkedIn slug (parsed from the URL).
name → fuzzy match; returns up to 10 ranked candidates with a relevance score.
If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin > domain > name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: "not_found" with an empty matches array.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"OpenFunnel","colors":{"primary":"#171717","light":"#FFFFFF","dark":"#0A0A0A"},"logo":{"light":"https://mintcdn.com/openfunnel/hnkIw4kHPQMkfgJ2/logo/light.svg?fit=max\u0026auto=format\u0026n=hnkIw4kHPQMkfgJ2\u0026q=85\u0026s=f89bea888c652ef8e10e7421c546e903","dark":"https://mintcdn.com/openfunnel/hnkIw4kHPQMkfgJ2/logo/dark.svg?fit=max\u0026auto=format\u0026n=hnkIw4kHPQMkfgJ2\u0026q=85\u0026s=d13743c138aa30eeb4e1cf0cab414f69"},"favicon":"https://mintcdn.com/openfunnel/ARm8otIZ0fbDIcy_/favicon.svg?fit=max\u0026auto=format\u0026n=ARm8otIZ0fbDIcy_\u0026q=85\u0026s=d3b1bd7cf0f024395562483af6827e3c","api":{},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"mailto:fenil@openfunnel.dev","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/openfunnel","linkedin":"https://www.linkedin.com/company/openfunnel"}},"seo":{"metatags":{"title":"OpenFunnel Docs","description":"Headless agent primitive APIs for developers and agents.","canonical":"https://docs.openfunnel.dev"},"indexing":"all"},"fonts":{"heading":{"family":"Geist","weight":600},"body":{"family":"Geist"}},"styling":{"eyebrows":"section","codeblocks":"dark","latex":false},"integrations":{"gtm":{"tagId":"GTM-KGXK48TP"},"posthog":{"apiKey":"phc_dHu28zQTgR6Yrd9K1K8m3yMBSJzPaiyxxCgb0JHZFXN","apiHost":"https://us.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openfunnel","hasAudioNarration":false,"actualSubdomain":"openfunnel","customDomains":["docs.openfunnel.dev"],"gitSource":{"type":"github","owner":"openfunnel","repo":"openfunnel-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae922272e86bd0c1830266b:success","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Agent Primitives","count":13},{"language":"default","tag":"Helpers","count":6},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Primitives","count":4},{"language":"default","tag":"MCP Server","count":2},{"language":"default","tag":"Get Started","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--font-family-mono-custom: \"Geist Mono\", ui-monospace, SFMono-Regular,\n \"SF Mono\", Menlo, Consolas, monospace}code,pre,kbd,samp,tt,[class*=\"font-mono\"],[class*=\"font-family-mono\"]{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo,\n Consolas, monospace!important}[class*=\"rounded\"]{border-radius:0!important}pre,code,kbd,img,video,button,input,select,textarea,table,th,td,hr,blockquote,.prose img,.prose pre,.prose code,.prose table{border-radius:0!important}card,accordion,accordiongroup,cardgroup,note,warning,info,tip,check,tabs,frame,columns,expandable,tooltip,update,steps{border-radius:0!important}[class*=\"rounded-full\"]{border-radius:9999px!important}a:has(>img.nav-logo){display:inline-flex!important;align-items:center}a:has(>img.nav-logo)::after{content:\"OpenFunnel\";margin-left:0.5rem;font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace;font-weight:600;font-size:1.05rem;letter-spacing:-0.01em;color:currentColor;white-space:nowrap}"}],"page":{"pagePath":"helpers/lookup-companies","slug":"/helpers/lookup-companies","pageMetadata":{"title":"Lookup Companies","openapi":"agent-primitives/openapi.json POST /api/v1/account/lookup-companies","description":"Resolve companies to their canonical OpenFunnel record(s) by any subset of **name / domain / linkedin_url**. Batch up to **100** per call. **No credits are charged.**\n\n\u003cInfo>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.\u003c/Info>\n\nEach item may carry any combination of identifiers:\n- **domain** → exact match on any of the company's domains. Returns all matching records.\n- **linkedin_url** → exact match on the company's LinkedIn slug (parsed from the URL).\n- **name** → fuzzy match; returns up to 10 ranked candidates with a relevance `score`.\n\nIf an item includes a `domain` or `linkedin_url`, it is resolved by that exact identifier and the `name` is ignored - the fuzzy name path runs only when `name` is the sole identifier. Matches are deduped by `company_id` (precedence: linkedin > domain > name). A returned `company_id` can be passed straight back into Search Lookalikes as a seed. Unknown inputs return `status: \"not_found\"` with an empty `matches` array.","href":"/helpers/lookup-companies"},"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 a: \"a\",\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {Info} = _components;\n if (!Info) _missingMdxReference(\"Info\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Resolve companies to their canonical OpenFunnel record(s) by any subset of \", _jsx(_components.strong, {\n children: \"name / domain / linkedin_url\"\n }), \". Batch up to \", _jsx(_components.strong, {\n children: \"100\"\n }), \" per call. \", _jsx(_components.strong, {\n children: \"No credits are charged.\"\n })]\n }), \"\\n\", _jsxs(Info, {\n children: [_jsx(_components.strong, {\n children: \"No API key yet?\"\n }), \" \", _jsx(_components.a, {\n href: \"/agent-primitives/authentication\",\n children: \"Sign up via Agent Auth\"\n }), \" to get your \", _jsx(_components.code, {\n children: \"X-API-Key\"\n }), \" - the only required header for this endpoint.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Each item may carry any combination of identifiers:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"domain\"\n }), \" → exact match on any of the company’s domains. Returns all matching records.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"linkedin_url\"\n }), \" → exact match on the company’s LinkedIn slug (parsed from the URL).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"name\"\n }), \" → fuzzy match; returns up to 10 ranked candidates with a relevance \", _jsx(_components.code, {\n children: \"score\"\n }), \".\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If an item includes a \", _jsx(_components.code, {\n children: \"domain\"\n }), \" or \", _jsx(_components.code, {\n children: \"linkedin_url\"\n }), \", it is resolved by that exact identifier and the \", _jsx(_components.code, {\n children: \"name\"\n }), \" is ignored - the fuzzy name path runs only when \", _jsx(_components.code, {\n children: \"name\"\n }), \" is the sole identifier. Matches are deduped by \", _jsx(_components.code, {\n children: \"company_id\"\n }), \" (precedence: linkedin > domain > name). A returned \", _jsx(_components.code, {\n children: \"company_id\"\n }), \" can be passed straight back into Search Lookalikes as a seed. Unknown inputs return \", _jsx(_components.code, {\n children: \"status: \\\"not_found\\\"\"\n }), \" with an empty \", _jsx(_components.code, {\n children: \"matches\"\n }), \" array.\"]\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};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Lookup Companies","openapi":"agent-primitives/openapi.json POST /api/v1/account/lookup-companies","description":"Resolve companies to their canonical OpenFunnel record(s) by any subset of **name / domain / linkedin_url**. Batch up to **100** per call. **No credits are charged.**\n\n\u003cInfo>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.\u003c/Info>\n\nEach item may carry any combination of identifiers:\n- **domain** → exact match on any of the company's domains. Returns all matching records.\n- **linkedin_url** → exact match on the company's LinkedIn slug (parsed from the URL).\n- **name** → fuzzy match; returns up to 10 ranked candidates with a relevance `score`.\n\nIf an item includes a `domain` or `linkedin_url`, it is resolved by that exact identifier and the `name` is ignored - the fuzzy name path runs only when `name` is the sole identifier. Matches are deduped by `company_id` (precedence: linkedin > domain > name). A returned `company_id` can be passed straight back into Search Lookalikes as a seed. Unknown inputs return `status: \"not_found\"` with an empty `matches` array.","href":"/helpers/lookup-companies"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Company Lookup"],"summary":"Lookup Companies","description":"Resolve companies to their canonical OpenFunnel record(s) by any subset of **name / domain / linkedin_url**. Batch up to **100** per call. **No credits are charged.**\n\n\u003cInfo>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.\u003c/Info>\n\nEach item may carry any combination of identifiers:\n- **domain** → exact match on any of the company's domains. Returns all matching records.\n- **linkedin_url** → exact match on the company's LinkedIn slug (parsed from the URL).\n- **name** → fuzzy match; returns up to 10 ranked candidates with a relevance `score`.\n\nIf an item includes a `domain` or `linkedin_url`, it is resolved by that exact identifier and the `name` is ignored - the fuzzy name path runs only when `name` is the sole identifier. Matches are deduped by `company_id` (precedence: linkedin > domain > name). A returned `company_id` can be passed straight back into Search Lookalikes as a seed. Unknown inputs return `status: \"not_found\"` with an empty `matches` array.","operationId":"lookup_companies_api_v1_account_lookup_companies_post","parameters":["270f9a96-0e16-45dd-83bd-4b3b377bf39e"],"requestBody":"ccae98e0-77ee-4ee6-9adc-278ba2b5964d","responses":{"200":"c503b615-db20-4d95-a37b-94c2d9260a99","422":"1ccbb614-a96d-4d2e-afc1-71f22cf3144b"},"x-codeSamples":[{"lang":"bash","label":"Lookup companies","source":"curl -sS -X POST \"https://api.openfunnel.dev/api/v1/account/lookup-companies\" \\\n -H \"X-API-Key: YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"companies\": [{\"domain\": \"stripe.com\"}, {\"linkedin_url\": \"https://www.linkedin.com/company/adyen\"}, {\"name\": \"Plaid\"}]}'"}],"method":"post","type":"path","servers":["740fd47c-d022-4880-b24a-1a0d0b6aaaac"],"security":[],"path":"/api/v1/account/lookup-companies","baseUrlOptions":["https://api.openfunnel.dev"],"title":"Lookup Companies","codeSamples":[{"label":"Lookup companies","lang":"bash","source":"curl -sS -X POST \"https://api.openfunnel.dev/api/v1/account/lookup-companies\" \\\n -H \"X-API-Key: YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"companies\": [{\"domain\": \"stripe.com\"}, {\"linkedin_url\": \"https://www.linkedin.com/company/adyen\"}, {\"name\": \"Plaid\"}]}'"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"270f9a96-0e16-45dd-83bd-4b3b377bf39e":{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"CompanyLookupRequest","description":"Batch company lookup: resolve up to 100 companies by identifier.","required":["companies"],"properties":{"companies":{"type":"array","items":{"type":"object","title":"CompanyLookupItem","description":"One company to resolve, identified by any subset of name/domain/linkedin_url. At least one is required.","properties":{"name":{"oneOf":[{"type":"string","title":"Name","description":"Company name. Fuzzy - resolves to ranked candidates.","maxLength":200,"uniqueKey":"companies.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Company name. Fuzzy - resolves to ranked candidates.","uniqueKey":"companies.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","title":"Domain","description":"Company website/domain (e.g. stripe.com). Matched on the primary domain.","uniqueKey":"companies.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","description":"Company website/domain (e.g. stripe.com). Matched on the primary domain.","uniqueKey":"companies.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].domain","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","description":"Company LinkedIn URL. Matched on the company slug parsed from the URL.","uniqueKey":"companies.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","description":"Company LinkedIn URL. Matched on the company slug parsed from the URL.","uniqueKey":"companies.items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].linkedin_url","typeLabel":"string | null"}},"uniqueKey":"companies.items.[INDEX]","typeLabel":"CompanyLookupItem · object"},"minItems":1,"maxItems":100,"title":"Companies","description":"1-100 companies to resolve.","isRequired":true,"uniqueKey":"companies","typeLabel":"CompanyLookupItem · object[]"}},"uniqueKey":"","typeLabel":"CompanyLookupRequest · object"},"examples":{"Example":{"title":"Example","value":{"companies":[{"name":"\u003cstring>","domain":"\u003cstring>","linkedin_url":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c503b615-db20-4d95-a37b-94c2d9260a99":{"description":"One result per input company, in request order.","content":{"application/json":{"schema":{"type":"object","title":"CompanyLookupResponse","description":"Response for the batch company lookup endpoint (one result per input, in request order).","required":["results"],"properties":{"results":{"type":"array","items":{"type":"object","title":"CompanyLookupItemResult","description":"Resolution result for one input company.","required":["input","status"],"properties":{"input":{"type":"object","title":"CompanyLookupInput","description":"The identifiers supplied for this item.","properties":{"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].input.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].input.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].input.name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","title":"Domain","uniqueKey":"results.items.[INDEX].input.domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","uniqueKey":"results.items.[INDEX].input.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].input.domain","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].input.linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].input.linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].input.linkedin_url","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"results.items.[INDEX].input","typeLabel":"CompanyLookupInput · object"},"status":{"type":"string","title":"Status","description":"`resolved` if any match, else `not_found`.","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"string"},"matches":{"type":"array","items":{"type":"object","title":"CompanyLookupMatch","description":"A company matched against one lookup item.","required":["matched_on"],"properties":{"matched_on":{"type":"string","title":"Matched On","description":"Which identifier matched: `domain`, `linkedin`, or `name`.","isRequired":true,"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].matched_on","typeLabel":"string"},"company_id":{"oneOf":[{"type":"string","title":"Company Id","description":"Canonical company id, reusable as a seed in Search Lookalikes.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company Id","description":"Canonical company id, reusable as a seed in Search Lookalikes.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].company_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","title":"Domain","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].domain","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_url","typeLabel":"string | null"},"linkedin_slug":{"oneOf":[{"type":"string","title":"Linkedin Slug","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_slug.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Slug","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].linkedin_slug","typeLabel":"string | null"},"employee_count_min":{"oneOf":[{"type":"integer","title":"Employee Count Min","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_min.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Employee Count Min","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_min.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_min","typeLabel":"integer | null"},"employee_count_max":{"oneOf":[{"type":"integer","title":"Employee Count Max","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_max.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Employee Count Max","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_max.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].employee_count_max","typeLabel":"integer | null"},"stage":{"oneOf":[{"type":"string","title":"Stage","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].stage.oneOf.0","typeLabel":"string"},{"type":"null","title":"Stage","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].stage.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].stage","typeLabel":"string | null"},"industries":{"oneOf":[{"type":"string","title":"Industries","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].industries.oneOf.0","typeLabel":"string"},{"type":"null","title":"Industries","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].industries.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].industries","typeLabel":"string | null"},"location_city":{"oneOf":[{"type":"string","title":"Location City","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_city.oneOf.0","typeLabel":"string"},{"type":"null","title":"Location City","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_city.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_city","typeLabel":"string | null"},"location_country":{"oneOf":[{"type":"string","title":"Location Country","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country.oneOf.0","typeLabel":"string"},{"type":"null","title":"Location Country","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country","typeLabel":"string | null"},"location_country_code":{"oneOf":[{"type":"string","title":"Location Country Code","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Location Country Code","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].location_country_code","typeLabel":"string | null"},"score":{"oneOf":[{"type":"number","title":"Score","description":"Relevance score (0-1) for `name` matches; null for exact domain/linkedin matches.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Score","description":"Relevance score (0-1) for `name` matches; null for exact domain/linkedin matches.","uniqueKey":"results.items.[INDEX].matches.items.[INDEX].score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].matches.items.[INDEX].score","typeLabel":"number | null"}},"uniqueKey":"results.items.[INDEX].matches.items.[INDEX]","typeLabel":"CompanyLookupMatch · object"},"title":"Matches","description":"Matched companies, deduped by company_id.","uniqueKey":"results.items.[INDEX].matches","typeLabel":"CompanyLookupMatch · object[]"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"CompanyLookupItemResult · object"},"title":"Results","isRequired":true,"uniqueKey":"results","typeLabel":"CompanyLookupItemResult · object[]"}},"uniqueKey":"","typeLabel":"CompanyLookupResponse · object"},"example":{"results":[{"input":{"name":null,"domain":"stripe.com","linkedin_url":null},"status":"resolved","matches":[{"company_id":"ww_39dde6f3035d07e7e55e882f05ec6d7e","name":"Stripe","domain":"stripe.com","linkedin_url":"https://www.linkedin.com/company/stripe","linkedin_slug":"stripe","employee_count_min":5000,"employee_count_max":10000,"stage":"private_equity","industries":"Financial Services, FinTech","location_city":"San Francisco","location_country":"United States","location_country_code":"us","matched_on":"domain","score":null}]},{"input":{"name":"Plaid","domain":null,"linkedin_url":null},"status":"resolved","matches":[{"company_id":"ww_55c8eee3a23eab95f8cc650641deea75","name":"Plaid","domain":"plaid.com","linkedin_url":"https://www.linkedin.com/company/plaid","linkedin_slug":"plaid","employee_count_min":1200,"employee_count_max":1200,"stage":"series_unknown","industries":"Finance, Banking, FinTech","location_city":"San Francisco","location_country":"United States","location_country_code":"us","matched_on":"name","score":0.97}]},{"input":{"name":null,"domain":"this-domain-does-not-exist-xyz.com","linkedin_url":null},"status":"not_found","matches":[]}]},"examples":{"Example":{"title":"Example","value":{"results":[{"input":{"name":null,"domain":"stripe.com","linkedin_url":null},"status":"resolved","matches":[{"company_id":"ww_39dde6f3035d07e7e55e882f05ec6d7e","name":"Stripe","domain":"stripe.com","linkedin_url":"https://www.linkedin.com/company/stripe","linkedin_slug":"stripe","employee_count_min":5000,"employee_count_max":10000,"stage":"private_equity","industries":"Financial Services, FinTech","location_city":"San Francisco","location_country":"United States","location_country_code":"us","matched_on":"domain","score":null}]},{"input":{"name":"Plaid","domain":null,"linkedin_url":null},"status":"resolved","matches":[{"company_id":"ww_55c8eee3a23eab95f8cc650641deea75","name":"Plaid","domain":"plaid.com","linkedin_url":"https://www.linkedin.com/company/plaid","linkedin_slug":"plaid","employee_count_min":1200,"employee_count_max":1200,"stage":"series_unknown","industries":"Finance, Banking, FinTech","location_city":"San Francisco","location_country":"United States","location_country_code":"us","matched_on":"name","score":0.97}]},{"input":{"name":null,"domain":"this-domain-does-not-exist-xyz.com","linkedin_url":null},"status":"not_found","matches":[]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"1ccbb614-a96d-4d2e-afc1-71f22cf3144b":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"array","items":{"type":"object","required":["loc","msg","type"],"properties":{"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"detail.items.[INDEX]","typeLabel":"object"},"uniqueKey":"detail","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"740fd47c-d022-4880-b24a-1a0d0b6aaaac":{"url":"https://api.openfunnel.dev"}}},"originalFileLocation":"agent-primitives/openapi.json"},"subdomain":"openfunnel","siteName":"OpenFunnel","title":"Lookup Companies - OpenFunnel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-29T03:04:49.182Z","originalFileLocation":"helpers/lookup-companies.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=\"Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged. No API key yet? Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint. Each item may carry any combination of identifiers: - domain → exact match on any of the company\u0026#x27;s domains. Returns all matching records. - linkedin_url → exact match on the company\u0026#x27;s LinkedIn slug (parsed from the URL). - name → fuzzy match; returns up to 10 ranked candidates with a relevance score. If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin \u0026gt; domain \u0026gt; name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: \u0026quot;not_found\u0026quot; with an empty matches array.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenFunnel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_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/openfunnel/f6FiQzsgB5xxfEVi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Lookup Companies - OpenFunnel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged. No API key yet? Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint. Each item may carry any combination of identifiers: - domain → exact match on any of the company\u0026#x27;s domains. Returns all matching records. - linkedin_url → exact match on the company\u0026#x27;s LinkedIn slug (parsed from the URL). - name → fuzzy match; returns up to 10 ranked candidates with a relevance score. If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin \u0026gt; domain \u0026gt; name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: \u0026quot;not_found\u0026quot; with an empty matches array.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenFunnel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openfunnel.dev/helpers/lookup-companies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openfunnel.mintlify.site/_mintlify/api/og/v2?division=Helpers\u0026amp;title=Lookup+Companies\u0026amp;description=Resolve+companies+to+their+canonical+OpenFunnel+record%28s%29+by+any+subset+of+**name+%2F+domain+%2F+linkedin_url**.+Batch+up+to+**100**+per+call.+**No+credits+are+char\u0026amp;theme=d9508a451ce5121af1c5d7c4\u0026amp;signature=9b38393c1d1cdca91140ff8d681793674c123eaeb68cc3f284d8944b32439a1a\">\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=\"Lookup Companies - OpenFunnel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged. No API key yet? Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint. Each item may carry any combination of identifiers: - domain → exact match on any of the company\u0026#x27;s domains. Returns all matching records. - linkedin_url → exact match on the company\u0026#x27;s LinkedIn slug (parsed from the URL). - name → fuzzy match; returns up to 10 ranked candidates with a relevance score. If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin \u0026gt; domain \u0026gt; name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: \u0026quot;not_found\u0026quot; with an empty matches array.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openfunnel.mintlify.site/_mintlify/api/og/v2?division=Helpers\u0026amp;title=Lookup+Companies\u0026amp;description=Resolve+companies+to+their+canonical+OpenFunnel+record%28s%29+by+any+subset+of+**name+%2F+domain+%2F+linkedin_url**.+Batch+up+to+**100**+per+call.+**No+credits+are+char\u0026amp;theme=d9508a451ce5121af1c5d7c4\u0026amp;signature=9b38393c1d1cdca91140ff8d681793674c123eaeb68cc3f284d8944b32439a1a\">\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/openfunnel/f6FiQzsgB5xxfEVi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenFunnel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openfunnel.dev/helpers/lookup-companies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/helpers/lookup-companies.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openfunnel.dev/#organization\",\"name\":\"OpenFunnel\",\"url\":\"https://docs.openfunnel.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openfunnel/hnkIw4kHPQMkfgJ2/logo/light.svg?fit=max\u0026auto=format\u0026n=hnkIw4kHPQMkfgJ2\u0026q=85\u0026s=f89bea888c652ef8e10e7421c546e903\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openfunnel.dev#website\",\"name\":\"OpenFunnel\",\"url\":\"https://docs.openfunnel.dev\",\"publisher\":{\"@id\":\"https://docs.openfunnel.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openfunnel.dev/helpers/lookup-companies#webpage\",\"url\":\"https://docs.openfunnel.dev/helpers/lookup-companies\",\"name\":\"Lookup Companies\",\"description\":\"Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged. No API key yet? Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint. Each item may carry any combination of identifiers: - domain → exact match on any of the company's domains. Returns all matching records. - linkedin_url → exact match on the company's LinkedIn slug (parsed from the URL). - name → fuzzy match; returns up to 10 ranked candidates with a relevance score. If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin > domain > name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: \\\"not_found\\\" with an empty matches array.\",\"dateModified\":\"2026-06-29T03:04:49.182Z\",\"isPartOf\":{\"@id\":\"https://docs.openfunnel.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openfunnel.dev/helpers/lookup-companies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openfunnel.dev/helpers/lookup-companies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OpenFunnel\",\"item\":\"https://docs.openfunnel.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lookup Companies\",\"item\":\"https://docs.openfunnel.dev/helpers/lookup-companies\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openfunnel.dev/helpers/lookup-companies#apireference\",\"headline\":\"Lookup Companies\",\"name\":\"Lookup Companies\",\"description\":\"Resolve companies to their canonical OpenFunnel record(s) by any subset of name / domain / linkedin_url. Batch up to 100 per call. No credits are charged. No API key yet? Sign up via Agent Auth to get your X-API-Key - the only required header for this endpoint. Each item may carry any combination of identifiers: - domain → exact match on any of the company's domains. Returns all matching records. - linkedin_url → exact match on the company's LinkedIn slug (parsed from the URL). - name → fuzzy match; returns up to 10 ranked candidates with a relevance score. If an item includes a domain or linkedin_url, it is resolved by that exact identifier and the name is ignored - the fuzzy name path runs only when name is the sole identifier. Matches are deduped by company_id (precedence: linkedin > domain > name). A returned company_id can be passed straight back into Search Lookalikes as a seed. Unknown inputs return status: \\\"not_found\\\" with an empty matches array.\",\"url\":\"https://docs.openfunnel.dev/helpers/lookup-companies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openfunnel.dev/helpers/lookup-companies#webpage\"},\"dateModified\":\"2026-06-29T03:04:49.182Z\",\"publisher\":{\"@id\":\"https://docs.openfunnel.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openfunnel.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenFunnel\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenFunnel","nav":{"global":null,"tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":""}]},{"tab":"Agent Primitives","icon":"shapes","groups":[{"group":"Overview","public":true,"pages":[{"title":"Agent Primitives","href":"/agent-primitives/introduction"},{"title":"Authentication","href":"/agent-primitives/authentication"},{"title":"Credits","href":"/agent-primitives/credits"}]},{"group":"Primitives","public":true,"pages":[{"title":"Search Lookalikes","openapi":"agent-primitives/openapi.json GET /api/v1/account/search-lookalikes","href":"/agent-primitives/search-lookalikes"},{"title":"Search Lookalikes Bulk","openapi":"agent-primitives/openapi.json POST /api/v1/account/search-lookalikes-bulk","href":"/agent-primitives/search-lookalikes-bulk"},{"title":"Search Companies By Tech Stack","openapi":"agent-primitives/openapi.json GET /api/v2/tech/companies","href":"/agent-primitives/search-companies-by-tech-stack"},{"title":"Deep Research","openapi":"agent-primitives/openapi.json POST /api/v2/research/deep","description":"Decide whether a single, known company fits your criteria in terms of recent activity and organizational structure as a qualifier.\n\n\u003cInfo>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.\u003c/Info>\n\nCombine an activity question (answered from job postings) and a team-composition question (answered from LinkedIn people) in a single call, with cited evidence per stage. Provide a `domain` plus at least one of `activity_question` or `qualifier_question`.\n\nIf you are not sure which domain OpenFunnel has indexed for a company, call [Lookup Companies](/helpers/lookup-companies) first. It accepts company names, domains, and LinkedIn URLs and returns the normalized company/domain records you can pass into Deep Research.\n\nEach parameter is hard-wired to a specific data source - pick the one that matches where the answer lives:\n- **`activity_question`** → answered from the company's **recent job postings**. Use for hiring intent, team expansion, tech-stack adoption visible in JDs, geographic hiring footprint, count/spike questions, first-time hiring or first-time JD mentions, and recent-hire intent.\n- **`qualifier_question`** → answered from **LinkedIn people data** (current-employee profiles). Use for team composition, roles already filled, org structure (e.g. \"has a Head of Security\", \"has ≥5 SDRs and a Sales Director\", \"has a dedicated AppSec team\").\n\nActivity question examples by category:\n- **Single-role hiring:** \"Is this company hiring SDRs based on recent job postings?\"; \"Do their recent job postings show developer relations engineer hiring?\"\n- **Initiative/team buildout:** \"Do their job descriptions suggest they are building an AI customer support automation team?\"; \"Do recent postings indicate they are staffing a data governance program?\"\n- **Tech/vendor/concept mentions:** \"Are they posting roles that mention Snowflake in at least 5 job descriptions in the last 90 days?\"; \"Do their job postings mention Salesforce more than 3 times this month?\"\n- **Role-count hiring:** \"Have they posted more than 5 SDR roles in the last 90 days?\"; \"Are they expanding platform engineering with at least 4 platform engineer postings in the last 60 days?\"\n- **Concept-count hiring:** \"Are they building around AI automation, with at least 4 related job postings this quarter?\"; \"Are they staffing generative AI work, with 6 or more related job postings in the last six months?\"\n- **Relative spikes:** \"Does their recent job activity show a spike in SDR hiring?\"; \"Are data engineer postings up 40% week over week?\"; \"Are Kubernetes mentions in their job descriptions up 80%?\"\n- **Recent-hire intent:** \"Does recent hiring activity suggest they brought someone in to build outbound sales?\"; \"Does recent hiring suggest they brought in a leader to stand up product security?\"\n- **First-time signals:** \"Is this the first time their job postings mention Kubernetes?\"; \"Are they hiring Solutions Engineers for the first time?\"; \"Does this look like their first Head of Data hire?\"\n\nQualifier question examples by category:\n- **Named team / product ownership:** \"Which engineers are in the Dropbox Dash team?\"; \"Which VP + sales people are in the AWS Textract team?\"\n- **Recent people changes:** \"New joiners in sales in the last 60 days\"; \"Any recent GTM engineering hires in sales in the last 90 days?\"\n- **Team-size / count checks:** \"Do they have more than 2 customer support people?\"; \"Do they have at least 5 SDRs/BDRs?\"\n- **Seniority / role coverage:** \"Do they have a VP or Head of Data Platform?\"; \"Do they have a Head of Security?\"\n- **Specialized teams / skills:** \"Do they have a dedicated AppSec / product-security team?\"; \"Do they employ Kubernetes-experienced platform engineers?\"\n\nPass both `activity_question` and `qualifier_question` when a question spans both signals - each stage runs against its own data source and returns independent evidence.\n\nEach stage returns a natural-language `answer` suitable for inline display, a boolean `qualified` verdict, and structured source evidence. Activity evidence is returned in `activity.sources`; qualifier evidence is returned in `qualifier.sources`. Job sources include title, URL, location, created timestamp, and why-relevant reason. People sources include name, title, LinkedIn URL, seniority, department, and start date when available.\n\nCredits: charged **per call**, not per source returned. 1 successful call (at least one stage produced a finding) = 1 charge at the per-call price configured for your workspace. A 404 (domain could not be resolved) is free. The exact amount billed is returned in `credits_consumed` on every response.","href":"/agent-primitives/deep-research"}]},{"group":"Helpers","public":true,"pages":[{"title":"Lookup Companies","openapi":"agent-primitives/openapi.json POST /api/v1/account/lookup-companies","href":"/helpers/lookup-companies"},{"title":"List Country Codes","openapi":"agent-primitives/openapi.json GET /api/v2/tech/country-options","description":"Returns the ISO 3166-1 **alpha-3** country codes accepted by the Agent Primitive search endpoints. Ordered by company volume so the highest-coverage codes (USA, GBR, CHN, FRA, IND, DEU, ...) come first.\n\n**Where these codes are used:**\n- `GET /api/v2/tech/companies` - `hq_country_code` parameter.\n\nOne-shot discovery call - static, safe to cache.","href":"/helpers/list-country-codes"},{"title":"List Firmographic Options","openapi":"agent-primitives/openapi.json GET /api/v1/account/firmographic-options","href":"/helpers/list-firmographic-options"},{"title":"Search Lookalikes Bulk Results","openapi":"agent-primitives/openapi.json GET /api/v1/account/search-lookalikes-bulk/{job_id}","href":"/helpers/search-lookalikes-bulk-results"},{"title":"Cancel Bulk Lookalike Job","openapi":"agent-primitives/openapi.json POST /api/v1/account/search-lookalikes-bulk/{job_id}/cancel","href":"/helpers/cancel-bulk-lookalike-job"},{"title":"Get Credit Balance","openapi":"agent-primitives/openapi.json GET /api/v1/credits/balance","href":"/helpers/get-credit-balance"}]}]},{"tab":"MCP Server","icon":"plug","pages":[{"title":"MCP Server","href":"/mcp-server"}]}]},"basePath":"","title":"Lookup Companies - OpenFunnel","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-D9ithiIZ.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}