{
"success": false,
"error": "Your are not authorized. Please check your api_key."
}
{
"success": false,
"message": "Company finder request not found."
}
Poll on status, not on the HTTP status code.While the search is running this endpoint answers 202 Accepted with a body that has no
companies and no summary. Once it is done it answers 200 OK with status set to
terminated or on_hold.Always branch on body.status, never on the HTTP code alone.
See Request statuses for the full lifecycle and a polling recipe.
Only present once status is terminated. An empty array when nothing matched.
Show child attributes
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"BetterContact","colors":{"primary":"#4C18BF","light":"#BCB1FF","dark":"#220E5F"},"favicon":"https://mintcdn.com/bettercontact/WPzhcW_OFl1ozX6a/favicon.svg?fit=max\u0026auto=format\u0026n=WPzhcW_OFl1ozX6a\u0026q=85\u0026s=e9b48730282d9c337149b7db3eeee349","logo":{"light":"https://mintcdn.com/bettercontact/WPzhcW_OFl1ozX6a/logo/light.svg?fit=max\u0026auto=format\u0026n=WPzhcW_OFl1ozX6a\u0026q=85\u0026s=a22e469f12b96e1c55f64158f7b665ad","dark":"https://mintcdn.com/bettercontact/WPzhcW_OFl1ozX6a/logo/dark.svg?fit=max\u0026auto=format\u0026n=WPzhcW_OFl1ozX6a\u0026q=85\u0026s=ef95051cf190c2279c92c118630bfdc0"},"navbar":{"links":[{"label":"Support","href":"mailto:[email protected]"}],"primary":{"type":"button","label":"Go to app","href":"https://app.bettercontact.rocks"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/bettercontact/"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","href":"https://app.bettercontact.rocks","icon":"square-code"},{"anchor":"Blog","href":"https://bettercontact.rocks/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bettercontact","hasAudioNarration":false,"actualSubdomain":"bettercontact","customDomains":["doc.bettercontact.rocks"],"gitSource":{"type":"github","owner":"bettercontactorg","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6abbc814018f6a8bb47e72ff","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Using the API","count":6},{"language":"default","tag":"Lead Finder - Get new leads","count":3},{"language":"default","tag":"Company Finder - Get new companies","count":2},{"language":"default","tag":"Waterfall enrichment - Get phone and email","count":2},{"language":"default","tag":"Enrich Profile","count":2},{"language":"default","tag":"My account","count":1},{"language":"default","tag":"Get Started","count":1}]},"assistantConfig":{},"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":"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":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/company_finder_get","slug":"/api-reference/endpoint/company_finder_get","pageMetadata":{"title":"Get a Company Finder Search results","description":"Get companies from a submitted Company Finder search.","openapi":"GET /company_finder/async/{request_id}","href":"/api-reference/endpoint/company_finder_get"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get companies from a submitted Company Finder search.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Poll on `,_jsx(_components.code,{children:`status`}),`, not on the HTTP status code.`]})}),_jsxs(_components.p,{children:[`While the search is running this endpoint answers `,_jsx(_components.code,{children:`202 Accepted`}),` with a body that has no\n`,_jsx(_components.code,{children:`companies`}),` and no `,_jsx(_components.code,{children:`summary`}),`. Once it is done it answers `,_jsx(_components.code,{children:`200 OK`}),` with `,_jsx(_components.code,{children:`status`}),` set to\n`,_jsx(_components.code,{children:`terminated`}),` or `,_jsx(_components.code,{children:`on_hold`}),`.`]}),_jsxs(_components.p,{children:[`Always branch on `,_jsx(_components.code,{children:`body.status`}),`, never on the HTTP code alone.\nSee `,_jsx(_components.a,{href:`/api-reference/statuses`,children:`Request statuses`}),` for the full lifecycle and a polling recipe.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`reading-the-result`,children:`Reading the result`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`What you get`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`not_started`}),`, `,_jsx(_components.code,{children:`processing`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`202`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`credits_left`}),`, `,_jsx(_components.code,{children:`credits_consumed`}),`. Poll again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`terminated`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`summary`}),` and `,_jsx(_components.code,{children:`companies`}),`. When nothing matched, `,_jsx(_components.code,{children:`companies`}),` is `,_jsx(_components.code,{children:`[]`}),` and `,_jsx(_components.code,{children:`summary.companies_found`}),` is `,_jsx(_components.code,{children:`0`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`on_hold`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`No results. The balance could not cover a single company.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`An `,_jsx(_components.code,{children:`on_hold`}),` Company Finder search does `,_jsx(_components.strong,{children:`not`}),` resume after a top up. Top up, then submit the\nsearch again. Nothing was charged for the first one.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Put a timeout on your polling loop. If the search provider fails, the request can stay in\n`,_jsx(_components.code,{children:`processing`}),` instead of moving to a final status.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`credits_left`}),` and `,_jsx(_components.code,{children:`credits_consumed`}),` are returned as decimal strings, for example `,_jsx(_components.code,{children:`\"998.5\"`}),`. Parse\nthem before doing arithmetic.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a Company Finder Search results","description":"Get companies from a submitted Company Finder search.","openapi":"GET /company_finder/async/{request_id}","href":"/api-reference/endpoint/company_finder_get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Reading the result","slug":"reading-the-result","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get Company Finder search results","operationId":"getCompanyFinderSearch","description":"Get companies from a submitted Company Finder search.","parameters":["b7ecc4a3-8702-4cb6-b1bc-9a3ad4a27634"],"security":["4d519fdb-9e4e-4a1d-8605-1e1dfbc8740c"],"responses":{"200":"16904ba6-d9d5-42db-9c63-ae6ed11d25d4","202":"d812034a-70a0-4896-8545-93b3de3fb727","401":"6a641706-2084-4b6a-909b-5aac0017f6dc","404":"4fb56836-8144-44b8-be05-cc32eee072c0"},"method":"get","type":"path","servers":["d5c9545b-c0e3-4548-b805-360646944cfa"],"path":"/company_finder/async/{request_id}","baseUrlOptions":["https://app.bettercontact.rocks/api/v2"],"title":"Get Company Finder search results","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b7ecc4a3-8702-4cb6-b1bc-9a3ad4a27634":{"name":"request_id","in":"path","required":true,"description":"The `request_id` returned by `POST /company_finder/async`.","schema":{"type":"string","isRequired":true,"description":"The `request_id` returned by `POST /company_finder/async`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"16904ba6-d9d5-42db-9c63-ae6ed11d25d4":{"description":"Search finished. `status` is `terminated` (`companies` and `summary` present, `companies` possibly empty) or `on_hold` (not enough credits for a single company).","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The `request_id` of this search.","example":"bc39ffbfc24cf043b748","uniqueKey":"id","typeLabel":"string"},"status":{"type":"string","enum":["not_started","processing","on_hold","terminated"],"example":"terminated","description":"See [Request statuses](/api-reference/statuses). A search that matched nothing is reported as `terminated` with an empty `companies` array.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"credits_consumed":{"type":"string","description":"Credits spent by this search, as a decimal string.","example":"2.5","uniqueKey":"credits_consumed","typeLabel":"string"},"credits_left":{"type":"string","description":"Credits remaining on the account, as a decimal string.","example":"998.5","uniqueKey":"credits_left","typeLabel":"string"},"summary":{"type":"object","description":"Only present once `status` is `terminated`.","properties":{"companies_found":{"type":"integer","description":"Total number of companies matching the filters, regardless of `limit`. Use it to size your pagination.","example":68067,"uniqueKey":"summary.companies_found","typeLabel":"integer"},"limit":{"type":"integer","description":"The `limit` used for this page.","example":25,"uniqueKey":"summary.limit","typeLabel":"integer"},"offset":{"type":"integer","description":"The `offset` used for this page.","example":0,"uniqueKey":"summary.offset","typeLabel":"integer"}},"uniqueKey":"summary","typeLabel":"object"},"companies":{"type":"array","description":"Only present once `status` is `terminated`. An empty array when nothing matched.","items":{"type":"object","description":"One company returned by the search. A field is `null` when the value is unknown.","properties":{"company_id":{"type":"integer","description":"BetterContact identifier for this company.","example":42,"uniqueKey":"companies.items.[INDEX].company_id","typeLabel":"integer"},"company_name":{"type":"string","example":"Acme","uniqueKey":"companies.items.[INDEX].company_name","typeLabel":"string"},"company_domain":{"type":"string","example":"acme.com","uniqueKey":"companies.items.[INDEX].company_domain","typeLabel":"string"},"company_website":{"oneOf":[{"type":"string","example":"acme.com","description":"Website, usually a bare domain without scheme.","uniqueKey":"companies.items.[INDEX].company_website.oneOf.0","typeLabel":"string"},{"type":"null","example":"acme.com","description":"Website, usually a bare domain without scheme.","uniqueKey":"companies.items.[INDEX].company_website.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_website","typeLabel":"string | null"},"company_linkedin_url":{"oneOf":[{"type":"string","example":"https://www.linkedin.com/company/acme","uniqueKey":"companies.items.[INDEX].company_linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://www.linkedin.com/company/acme","uniqueKey":"companies.items.[INDEX].company_linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_linkedin_url","typeLabel":"string | null"},"company_crunchbase_url":{"oneOf":[{"type":"string","example":"https://www.crunchbase.com/organization/acme","uniqueKey":"companies.items.[INDEX].company_crunchbase_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://www.crunchbase.com/organization/acme","uniqueKey":"companies.items.[INDEX].company_crunchbase_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_crunchbase_url","typeLabel":"string | null"},"company_logo_url":{"oneOf":[{"type":"string","example":"https://logo.example/acme.png","uniqueKey":"companies.items.[INDEX].company_logo_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://logo.example/acme.png","uniqueKey":"companies.items.[INDEX].company_logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_logo_url","typeLabel":"string | null"},"company_industry":{"oneOf":[{"type":"string","example":"Software","uniqueKey":"companies.items.[INDEX].company_industry.oneOf.0","typeLabel":"string"},{"type":"null","example":"Software","uniqueKey":"companies.items.[INDEX].company_industry.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_industry","typeLabel":"string | null"},"company_type":{"oneOf":[{"type":"string","example":"Privately Held","uniqueKey":"companies.items.[INDEX].company_type.oneOf.0","typeLabel":"string"},{"type":"null","example":"Privately Held","uniqueKey":"companies.items.[INDEX].company_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_type","typeLabel":"string | null"},"company_description":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].company_description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].company_description.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_description","typeLabel":"string | null"},"company_founded_year":{"oneOf":[{"type":"integer","example":2012,"uniqueKey":"companies.items.[INDEX].company_founded_year.oneOf.0","typeLabel":"integer"},{"type":"null","example":2012,"uniqueKey":"companies.items.[INDEX].company_founded_year.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_founded_year","typeLabel":"integer | null"},"company_keywords":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["saas"],"uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"example":["saas"],"uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_keywords","typeLabel":"string[] | null"},"company_technologies":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["Ruby","PostgreSQL"],"uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"example":["Ruby","PostgreSQL"],"uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_technologies","typeLabel":"string[] | null"},"company_employees_range_start":{"oneOf":[{"type":"integer","description":"Lower bound of the headcount range.","example":51,"uniqueKey":"companies.items.[INDEX].company_employees_range_start.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Lower bound of the headcount range.","example":51,"uniqueKey":"companies.items.[INDEX].company_employees_range_start.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_range_start","typeLabel":"integer | null"},"company_employees_range_end":{"oneOf":[{"type":"integer","description":"Upper bound of the headcount range.","example":200,"uniqueKey":"companies.items.[INDEX].company_employees_range_end.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Upper bound of the headcount range.","example":200,"uniqueKey":"companies.items.[INDEX].company_employees_range_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_range_end","typeLabel":"integer | null"},"company_employees_count":{"oneOf":[{"type":"integer","description":"Exact employee count, when known.","example":120,"uniqueKey":"companies.items.[INDEX].company_employees_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Exact employee count, when known.","example":120,"uniqueKey":"companies.items.[INDEX].company_employees_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_count","typeLabel":"integer | null"},"company_employees_by_department":{"oneOf":[{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.0.additionalProperties","typeLabel":"integer"},"description":"Headcount per department.","example":{"Engineering":40,"Sales":15},"uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"integer","uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.1.additionalProperties","typeLabel":"integer"},"description":"Headcount per department.","example":{"Engineering":40,"Sales":15},"uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_by_department","typeLabel":"object | null"},"company_size_range":{"oneOf":[{"type":"string","example":"51-200","uniqueKey":"companies.items.[INDEX].company_size_range.oneOf.0","typeLabel":"string"},{"type":"null","example":"51-200","uniqueKey":"companies.items.[INDEX].company_size_range.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_size_range","typeLabel":"string | null"},"company_revenue_range":{"oneOf":[{"type":"string","example":"$10M-$50M","uniqueKey":"companies.items.[INDEX].company_revenue_range.oneOf.0","typeLabel":"string"},{"type":"null","example":"$10M-$50M","uniqueKey":"companies.items.[INDEX].company_revenue_range.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_revenue_range","typeLabel":"string | null"},"company_locations_count":{"oneOf":[{"type":"integer","description":"Number of company locations.","example":3,"uniqueKey":"companies.items.[INDEX].company_locations_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of company locations.","example":3,"uniqueKey":"companies.items.[INDEX].company_locations_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_locations_count","typeLabel":"integer | null"},"company_last_funding_round_name":{"oneOf":[{"type":"string","example":"Series B","uniqueKey":"companies.items.[INDEX].company_last_funding_round_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Series B","uniqueKey":"companies.items.[INDEX].company_last_funding_round_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_funding_round_name","typeLabel":"string | null"},"company_last_amount_raised_usd":{"oneOf":[{"type":"integer","example":25000000,"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd.oneOf.0","typeLabel":"integer"},{"type":"null","example":25000000,"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd","typeLabel":"integer | null"},"company_total_amount_raised_usd":{"oneOf":[{"type":"integer","example":40000000,"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd.oneOf.0","typeLabel":"integer"},{"type":"null","example":40000000,"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd","typeLabel":"integer | null"},"company_last_funding_date":{"oneOf":[{"type":"string","description":"`YYYY-MM-DD`.","example":"2024-06-01","uniqueKey":"companies.items.[INDEX].company_last_funding_date.oneOf.0","typeLabel":"string"},{"type":"null","description":"`YYYY-MM-DD`.","example":"2024-06-01","uniqueKey":"companies.items.[INDEX].company_last_funding_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_funding_date","typeLabel":"string | null"},"company_head_quarters_city":{"oneOf":[{"type":"string","example":"Austin","uniqueKey":"companies.items.[INDEX].company_head_quarters_city.oneOf.0","typeLabel":"string"},{"type":"null","example":"Austin","uniqueKey":"companies.items.[INDEX].company_head_quarters_city.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_city","typeLabel":"string | null"},"company_head_quarters_state":{"oneOf":[{"type":"string","example":"Texas","uniqueKey":"companies.items.[INDEX].company_head_quarters_state.oneOf.0","typeLabel":"string"},{"type":"null","example":"Texas","uniqueKey":"companies.items.[INDEX].company_head_quarters_state.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_state","typeLabel":"string | null"},"company_head_quarters_country":{"oneOf":[{"type":"string","example":"United States","uniqueKey":"companies.items.[INDEX].company_head_quarters_country.oneOf.0","typeLabel":"string"},{"type":"null","example":"United States","uniqueKey":"companies.items.[INDEX].company_head_quarters_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_country","typeLabel":"string | null"},"company_head_quarters_address":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].company_head_quarters_address.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].company_head_quarters_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_address","typeLabel":"string | null"},"company_active_job_postings_count":{"oneOf":[{"type":"integer","description":"Number of open roles, when known.","example":8,"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of open roles, when known.","example":8,"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count","typeLabel":"integer | null"}},"uniqueKey":"companies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"companies","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"bc39ffbfc24cf043b748","status":"terminated","credits_consumed":"2.5","credits_left":"998.5","summary":{"companies_found":68067,"limit":25,"offset":0},"companies":[{"company_id":42,"company_name":"Acme","company_domain":"acme.com","company_website":"acme.com","company_linkedin_url":"https://www.linkedin.com/company/acme","company_crunchbase_url":"https://www.crunchbase.com/organization/acme","company_logo_url":"https://logo.example/acme.png","company_industry":"Software","company_type":"Privately Held","company_description":"\u003cstring>","company_founded_year":2012,"company_keywords":["saas"],"company_technologies":["Ruby","PostgreSQL"],"company_employees_range_start":51,"company_employees_range_end":200,"company_employees_count":120,"company_employees_by_department":{"Engineering":40,"Sales":15},"company_size_range":"51-200","company_revenue_range":"$10M-$50M","company_locations_count":3,"company_last_funding_round_name":"Series B","company_last_amount_raised_usd":25000000,"company_total_amount_raised_usd":40000000,"company_last_funding_date":"2024-06-01","company_head_quarters_city":"Austin","company_head_quarters_state":"Texas","company_head_quarters_country":"United States","company_head_quarters_address":"\u003cstring>","company_active_job_postings_count":8}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d812034a-70a0-4896-8545-93b3de3fb727":{"description":"Request accepted but not finished yet. `companies` and `summary` are absent. Poll again later.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The `request_id` of this search.","example":"bc39ffbfc24cf043b748","uniqueKey":"id","typeLabel":"string"},"status":{"type":"string","enum":["not_started","processing","on_hold","terminated"],"example":"terminated","description":"See [Request statuses](/api-reference/statuses). A search that matched nothing is reported as `terminated` with an empty `companies` array.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"credits_consumed":{"type":"string","description":"Credits spent by this search, as a decimal string.","example":"2.5","uniqueKey":"credits_consumed","typeLabel":"string"},"credits_left":{"type":"string","description":"Credits remaining on the account, as a decimal string.","example":"998.5","uniqueKey":"credits_left","typeLabel":"string"},"summary":{"type":"object","description":"Only present once `status` is `terminated`.","properties":{"companies_found":{"type":"integer","description":"Total number of companies matching the filters, regardless of `limit`. Use it to size your pagination.","example":68067,"uniqueKey":"summary.companies_found","typeLabel":"integer"},"limit":{"type":"integer","description":"The `limit` used for this page.","example":25,"uniqueKey":"summary.limit","typeLabel":"integer"},"offset":{"type":"integer","description":"The `offset` used for this page.","example":0,"uniqueKey":"summary.offset","typeLabel":"integer"}},"uniqueKey":"summary","typeLabel":"object"},"companies":{"type":"array","description":"Only present once `status` is `terminated`. An empty array when nothing matched.","items":{"type":"object","description":"One company returned by the search. A field is `null` when the value is unknown.","properties":{"company_id":{"type":"integer","description":"BetterContact identifier for this company.","example":42,"uniqueKey":"companies.items.[INDEX].company_id","typeLabel":"integer"},"company_name":{"type":"string","example":"Acme","uniqueKey":"companies.items.[INDEX].company_name","typeLabel":"string"},"company_domain":{"type":"string","example":"acme.com","uniqueKey":"companies.items.[INDEX].company_domain","typeLabel":"string"},"company_website":{"oneOf":[{"type":"string","example":"acme.com","description":"Website, usually a bare domain without scheme.","uniqueKey":"companies.items.[INDEX].company_website.oneOf.0","typeLabel":"string"},{"type":"null","example":"acme.com","description":"Website, usually a bare domain without scheme.","uniqueKey":"companies.items.[INDEX].company_website.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_website","typeLabel":"string | null"},"company_linkedin_url":{"oneOf":[{"type":"string","example":"https://www.linkedin.com/company/acme","uniqueKey":"companies.items.[INDEX].company_linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://www.linkedin.com/company/acme","uniqueKey":"companies.items.[INDEX].company_linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_linkedin_url","typeLabel":"string | null"},"company_crunchbase_url":{"oneOf":[{"type":"string","example":"https://www.crunchbase.com/organization/acme","uniqueKey":"companies.items.[INDEX].company_crunchbase_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://www.crunchbase.com/organization/acme","uniqueKey":"companies.items.[INDEX].company_crunchbase_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_crunchbase_url","typeLabel":"string | null"},"company_logo_url":{"oneOf":[{"type":"string","example":"https://logo.example/acme.png","uniqueKey":"companies.items.[INDEX].company_logo_url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://logo.example/acme.png","uniqueKey":"companies.items.[INDEX].company_logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_logo_url","typeLabel":"string | null"},"company_industry":{"oneOf":[{"type":"string","example":"Software","uniqueKey":"companies.items.[INDEX].company_industry.oneOf.0","typeLabel":"string"},{"type":"null","example":"Software","uniqueKey":"companies.items.[INDEX].company_industry.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_industry","typeLabel":"string | null"},"company_type":{"oneOf":[{"type":"string","example":"Privately Held","uniqueKey":"companies.items.[INDEX].company_type.oneOf.0","typeLabel":"string"},{"type":"null","example":"Privately Held","uniqueKey":"companies.items.[INDEX].company_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_type","typeLabel":"string | null"},"company_description":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].company_description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].company_description.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_description","typeLabel":"string | null"},"company_founded_year":{"oneOf":[{"type":"integer","example":2012,"uniqueKey":"companies.items.[INDEX].company_founded_year.oneOf.0","typeLabel":"integer"},{"type":"null","example":2012,"uniqueKey":"companies.items.[INDEX].company_founded_year.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_founded_year","typeLabel":"integer | null"},"company_keywords":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["saas"],"uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"example":["saas"],"uniqueKey":"companies.items.[INDEX].company_keywords.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_keywords","typeLabel":"string[] | null"},"company_technologies":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["Ruby","PostgreSQL"],"uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"example":["Ruby","PostgreSQL"],"uniqueKey":"companies.items.[INDEX].company_technologies.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_technologies","typeLabel":"string[] | null"},"company_employees_range_start":{"oneOf":[{"type":"integer","description":"Lower bound of the headcount range.","example":51,"uniqueKey":"companies.items.[INDEX].company_employees_range_start.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Lower bound of the headcount range.","example":51,"uniqueKey":"companies.items.[INDEX].company_employees_range_start.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_range_start","typeLabel":"integer | null"},"company_employees_range_end":{"oneOf":[{"type":"integer","description":"Upper bound of the headcount range.","example":200,"uniqueKey":"companies.items.[INDEX].company_employees_range_end.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Upper bound of the headcount range.","example":200,"uniqueKey":"companies.items.[INDEX].company_employees_range_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_range_end","typeLabel":"integer | null"},"company_employees_count":{"oneOf":[{"type":"integer","description":"Exact employee count, when known.","example":120,"uniqueKey":"companies.items.[INDEX].company_employees_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Exact employee count, when known.","example":120,"uniqueKey":"companies.items.[INDEX].company_employees_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_count","typeLabel":"integer | null"},"company_employees_by_department":{"oneOf":[{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.0.additionalProperties","typeLabel":"integer"},"description":"Headcount per department.","example":{"Engineering":40,"Sales":15},"uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"integer","uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.1.additionalProperties","typeLabel":"integer"},"description":"Headcount per department.","example":{"Engineering":40,"Sales":15},"uniqueKey":"companies.items.[INDEX].company_employees_by_department.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_employees_by_department","typeLabel":"object | null"},"company_size_range":{"oneOf":[{"type":"string","example":"51-200","uniqueKey":"companies.items.[INDEX].company_size_range.oneOf.0","typeLabel":"string"},{"type":"null","example":"51-200","uniqueKey":"companies.items.[INDEX].company_size_range.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_size_range","typeLabel":"string | null"},"company_revenue_range":{"oneOf":[{"type":"string","example":"$10M-$50M","uniqueKey":"companies.items.[INDEX].company_revenue_range.oneOf.0","typeLabel":"string"},{"type":"null","example":"$10M-$50M","uniqueKey":"companies.items.[INDEX].company_revenue_range.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_revenue_range","typeLabel":"string | null"},"company_locations_count":{"oneOf":[{"type":"integer","description":"Number of company locations.","example":3,"uniqueKey":"companies.items.[INDEX].company_locations_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of company locations.","example":3,"uniqueKey":"companies.items.[INDEX].company_locations_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_locations_count","typeLabel":"integer | null"},"company_last_funding_round_name":{"oneOf":[{"type":"string","example":"Series B","uniqueKey":"companies.items.[INDEX].company_last_funding_round_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Series B","uniqueKey":"companies.items.[INDEX].company_last_funding_round_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_funding_round_name","typeLabel":"string | null"},"company_last_amount_raised_usd":{"oneOf":[{"type":"integer","example":25000000,"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd.oneOf.0","typeLabel":"integer"},{"type":"null","example":25000000,"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_amount_raised_usd","typeLabel":"integer | null"},"company_total_amount_raised_usd":{"oneOf":[{"type":"integer","example":40000000,"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd.oneOf.0","typeLabel":"integer"},{"type":"null","example":40000000,"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_total_amount_raised_usd","typeLabel":"integer | null"},"company_last_funding_date":{"oneOf":[{"type":"string","description":"`YYYY-MM-DD`.","example":"2024-06-01","uniqueKey":"companies.items.[INDEX].company_last_funding_date.oneOf.0","typeLabel":"string"},{"type":"null","description":"`YYYY-MM-DD`.","example":"2024-06-01","uniqueKey":"companies.items.[INDEX].company_last_funding_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_last_funding_date","typeLabel":"string | null"},"company_head_quarters_city":{"oneOf":[{"type":"string","example":"Austin","uniqueKey":"companies.items.[INDEX].company_head_quarters_city.oneOf.0","typeLabel":"string"},{"type":"null","example":"Austin","uniqueKey":"companies.items.[INDEX].company_head_quarters_city.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_city","typeLabel":"string | null"},"company_head_quarters_state":{"oneOf":[{"type":"string","example":"Texas","uniqueKey":"companies.items.[INDEX].company_head_quarters_state.oneOf.0","typeLabel":"string"},{"type":"null","example":"Texas","uniqueKey":"companies.items.[INDEX].company_head_quarters_state.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_state","typeLabel":"string | null"},"company_head_quarters_country":{"oneOf":[{"type":"string","example":"United States","uniqueKey":"companies.items.[INDEX].company_head_quarters_country.oneOf.0","typeLabel":"string"},{"type":"null","example":"United States","uniqueKey":"companies.items.[INDEX].company_head_quarters_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_country","typeLabel":"string | null"},"company_head_quarters_address":{"oneOf":[{"type":"string","uniqueKey":"companies.items.[INDEX].company_head_quarters_address.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companies.items.[INDEX].company_head_quarters_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_head_quarters_address","typeLabel":"string | null"},"company_active_job_postings_count":{"oneOf":[{"type":"integer","description":"Number of open roles, when known.","example":8,"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of open roles, when known.","example":8,"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"companies.items.[INDEX].company_active_job_postings_count","typeLabel":"integer | null"}},"uniqueKey":"companies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"companies","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"bc39ffbfc24cf043b748","status":"processing","credits_left":"999.0","credits_consumed":"0.0"},"examples":{"Example":{"title":"Example","value":{"id":"bc39ffbfc24cf043b748","status":"processing","credits_left":"999.0","credits_consumed":"0.0"}}},"exampleType":"examples"}},"exampleType":"examples"},"6a641706-2084-4b6a-909b-5aac0017f6dc":{"description":"Unauthorized. The API key is missing, invalid or deactivated.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"description":"Not returned by the enrichment endpoints.","uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Your are not authorized. Please check your api_key.","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Your are not authorized. Please check your api_key."}}},"exampleType":"generated"}},"exampleType":"generated"},"4fb56836-8144-44b8-be05-cc32eee072c0":{"description":"Unknown `request_id`, or the request belongs to another account.","content":{"application/json":{"schema":{"type":"object","description":"Generic error envelope. Depending on the endpoint the human readable text is carried by `error` or by `message`, so always read both.","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Human readable error message.","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human readable error message.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Company finder request not found."},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Company finder request not found."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4d519fdb-9e4e-4a1d-8605-1e1dfbc8740c":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]}}},"servers":{"d5c9545b-c0e3-4548-b805-360646944cfa":{"url":"https://app.bettercontact.rocks/api/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"bettercontact","siteName":"BetterContact","title":"Get a Company Finder Search results - BetterContact","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T14:16:22.513Z","originalFileLocation":"api-reference/endpoint/company_finder_get.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get companies from a submitted Company Finder search.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BetterContact\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_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/bettercontact/FrJEfEEe4YSzLTtY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a Company Finder Search results - BetterContact\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get companies from a submitted Company Finder search.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BetterContact\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bettercontact.mintlify.site/_mintlify/api/og/v2?division=Company+Finder+-+Get+new+companies\u0026amp;title=Get+a+Company+Finder+Search+results\u0026amp;description=Get+companies+from+a+submitted+Company+Finder+search.\u0026amp;theme=c8949fe1919d5339c6d11630\u0026amp;signature=45ec428dfc471acc5dc5c8b2b9a8a4aadea6dc162e9d27f6edbd202eee43218f\">\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=\"Get a Company Finder Search results - BetterContact\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get companies from a submitted Company Finder search.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bettercontact.mintlify.site/_mintlify/api/og/v2?division=Company+Finder+-+Get+new+companies\u0026amp;title=Get+a+Company+Finder+Search+results\u0026amp;description=Get+companies+from+a+submitted+Company+Finder+search.\u0026amp;theme=c8949fe1919d5339c6d11630\u0026amp;signature=45ec428dfc471acc5dc5c8b2b9a8a4aadea6dc162e9d27f6edbd202eee43218f\">\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/bettercontact/FrJEfEEe4YSzLTtY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BetterContact\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4C18BF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/company_finder_get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://doc.bettercontact.rocks/#organization\",\"name\":\"BetterContact\",\"url\":\"https://doc.bettercontact.rocks\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bettercontact/WPzhcW_OFl1ozX6a/logo/light.svg?fit=max\u0026auto=format\u0026n=WPzhcW_OFl1ozX6a\u0026q=85\u0026s=a22e469f12b96e1c55f64158f7b665ad\"}},{\"@type\":\"WebSite\",\"@id\":\"https://doc.bettercontact.rocks#website\",\"name\":\"BetterContact\",\"url\":\"https://doc.bettercontact.rocks\",\"publisher\":{\"@id\":\"https://doc.bettercontact.rocks/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get#webpage\",\"url\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get\",\"name\":\"Get a Company Finder Search results\",\"description\":\"Get companies from a submitted Company Finder search.\",\"dateModified\":\"2026-09-29T14:16:22.513Z\",\"isPartOf\":{\"@id\":\"https://doc.bettercontact.rocks#website\"},\"breadcrumb\":{\"@id\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company Finder - Get new companies\",\"item\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a Company Finder Search results\",\"item\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get#apireference\",\"headline\":\"Get a Company Finder Search results\",\"name\":\"Get a Company Finder Search results\",\"description\":\"Get companies from a submitted Company Finder search.\",\"url\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get\",\"mainEntityOfPage\":{\"@id\":\"https://doc.bettercontact.rocks/api-reference/endpoint/company_finder_get#webpage\"},\"dateModified\":\"2026-09-29T14:16:22.513Z\",\"publisher\":{\"@id\":\"https://doc.bettercontact.rocks/#organization\"},\"isPartOf\":{\"@id\":\"https://doc.bettercontact.rocks#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BetterContact\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"BetterContact","nav":{"global":{"anchors":[{"anchor":"App","href":"https://app.bettercontact.rocks","icon":"square-code"},{"anchor":"Blog","href":"https://bettercontact.rocks/blog","icon":"newspaper"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Quickstart","href":"/quickstart"}]},{"group":"Using the API","pages":[{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Request statuses","href":"/api-reference/statuses"},{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Credits","href":"/api-reference/credits"},{"title":"API Rate Limits","href":"/api-reference/api_rate_limits"}]},{"group":"Lead Finder - Get new leads","pages":[{"title":"New Lead Finder Search","openapi":"POST /lead_finder/async","href":"/api-reference/endpoint/lead_finder_post"},{"title":"Get a Lead Finder Search results","openapi":"GET /lead_finder/async/{request_id}","href":"/api-reference/endpoint/lead_finder_get"},{"title":"Taxonomies","href":"/api-reference/taxonomies"}]},{"group":"Company Finder - Get new companies","pages":[{"title":"New Company Finder Search","description":"Find companies that match firmographic, funding and hiring criteria.","openapi":"POST /company_finder/async","href":"/api-reference/endpoint/company_finder_post"},{"title":"Get a Company Finder Search results","openapi":"GET /company_finder/async/{request_id}","href":"/api-reference/endpoint/company_finder_get"}]},{"group":"Waterfall enrichment - Get phone and email","pages":[{"title":"Enrich leads","description":"Submit up to 100 leads for waterfall email and phone enrichment.","openapi":"POST /async","href":"/api-reference/endpoint/create"},{"title":"Get Enrichment Results","openapi":"GET /async/{request_id}","href":"/api-reference/endpoint/get"}]},{"group":"Enrich Profile","pages":[{"title":"Enrich a lead profile","openapi":"POST /enrich_profile/lead","href":"/api-reference/enrich_profile/lead"},{"title":"Enrich a company profile","openapi":"POST /enrich_profile/company","href":"/api-reference/enrich_profile/company"}]},{"group":"My account","pages":[{"title":"Check your credits balance","openapi":"GET /account","href":"/api-reference/endpoint/account"}]}]}]},"basePath":"","title":"Get a Company Finder Search results - BetterContact","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"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","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.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"]}