Resolve a company name from a customer email, chat message, or CRM record into a canonical BETA entity before calling other endpoints. /validate is a fast cache lookup — call it first to avoid wasted lookups on unknown or low-confidence inputs.
Request
string
required
Company name to validate. Must be 2–200 characters.
Response
boolean
true if BETA resolved the input. Always check resolution.confidence alongside this — verified: true with low confidence means a fuzzy/fallback match, not a confident one.
number
Confidence score (0–1) for the entity match.
object
Canonical entity record. null when verified: false.
See Citation Contract for how resolution.source and resolution.confidence are populated — and why verified: true with resolution.source: "sec_fallback" is not the same trust signal as resolution.source: "curated".
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BETA","colors":{"primary":"#0a0a0a","light":"#fafafa","dark":"#0a0a0a"},"logo":{"light":"https://mintcdn.com/caliko/5uVqCNQGCH7130tf/logo/light.svg?fit=max\u0026auto=format\u0026n=5uVqCNQGCH7130tf\u0026q=85\u0026s=a3036b5706a49ebe4241b42ff35fca0e","dark":"https://mintcdn.com/caliko/5uVqCNQGCH7130tf/logo/dark.svg?fit=max\u0026auto=format\u0026n=5uVqCNQGCH7130tf\u0026q=85\u0026s=9bece26a4e69f8ee8201233ff4a1d1bf","href":"https://getbeta.io"},"favicon":"https://mintcdn.com/caliko/5uVqCNQGCH7130tf/favicon.svg?fit=max\u0026auto=format\u0026n=5uVqCNQGCH7130tf\u0026q=85\u0026s=05c13a58d6bac178c38be8d647cdd2fe","navbar":{"links":[{"href":"https://getbeta.io","label":"getbeta.io"}],"primary":{"type":"button","label":"Get API key","href":"mailto:hello@getbeta.io?subject=API%20key%20request"}},"footer":{"socials":{"github":"https://github.com/caliko-llc/getbeta-mcp"}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist","weight":400}},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"MCP on npm","icon":"box-archive","href":"https://www.npmjs.com/package/@getbeta/mcp"},{"anchor":"GitHub","icon":"github","href":"https://github.com/caliko-llc/getbeta-mcp"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"caliko","hasAudioNarration":false,"actualSubdomain":"caliko","customDomains":["developers.getbeta.io"],"gitSource":{"type":"github","owner":"caliko-llc","repo":"getbeta-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae9581b9249234afda49bec:success","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":5},{"language":"default","tag":"Reference","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Recipes","count":3},{"language":"default","tag":"Citation Contract","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--inf-bg: #fafafa;--inf-bg-elevated: #ffffff;--inf-text: #0a0a0a;--inf-text-muted: #737373;--inf-text-faint: #a3a3a3;--inf-border: #e5e5e5;--inf-border-strong: #d4d4d4;--inf-status: #10b981}[data-theme=\"dark\"],.dark{--inf-bg: #0a0a0a;--inf-bg-elevated: #141414;--inf-text: #fafafa;--inf-text-muted: #a3a3a3;--inf-text-faint: #737373;--inf-border: #2a2a2a;--inf-border-strong: #404040}body,html{font-family:'Geist', system-ui, -apple-system, sans-serif!important}h1,h2,h3,h4,h5,h6{font-weight:500!important;letter-spacing:-0.02em!important}h1{letter-spacing:-0.03em!important}code,pre,.code-block,kbd{font-family:'Geist Mono', ui-monospace, SFMono-Regular, Menlo, monospace!important}hr{border-color:var(--inf-border)!important}button,.button{border-radius:2px!important}.status-up,.api-status-ok,[data-status=\"up\"]{color:var(--inf-status)!important}.sidebar-link,[class*=\"sidebar\"] a{letter-spacing:0.01em}:not(pre)>code{background:var(--inf-bg-elevated)!important;border:1px solid var(--inf-border)!important;border-radius:2px!important;padding:1px 6px!important;font-size:0.95em!important}"}],"page":{"pagePath":"endpoints/validate","slug":"/endpoints/validate","pageMetadata":{"title":"POST /validate","description":"Resolve a company string to a canonical entity.","api":"POST https://api.getbeta.io/api/v1/validate","href":"/endpoints/validate"},"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: \"Resolve a company string to a canonical entity.\"\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`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`use-case`,children:`Use case`}),`\n`,_jsxs(_components.p,{children:[`Resolve a company name from a customer email, chat message, or CRM record into a canonical BETA entity before calling other endpoints. `,_jsx(_components.code,{children:`/validate`}),` is a fast cache lookup — call it first to avoid wasted lookups on unknown or low-confidence inputs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(ParamField,{body:`company`,type:`string`,required:true,id:`param-company`,children:_jsx(_components.p,{children:`Company name to validate. Must be 2–200 characters.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`verified`,type:`boolean`,id:`param-verified`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` if BETA resolved the input. Always check `,_jsx(_components.code,{children:`resolution.confidence`}),` alongside this — `,_jsx(_components.code,{children:`verified: true`}),` with low confidence means a fuzzy/fallback match, not a confident one.`]})}),`\n`,_jsx(ResponseField,{name:`confidence`,type:`number`,id:`param-confidence`,children:_jsx(_components.p,{children:`Confidence score (0–1) for the entity match.`})}),`\n`,_jsxs(ResponseField,{name:`entity`,type:`object`,id:`param-entity`,children:[_jsxs(_components.p,{children:[`Canonical entity record. `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`verified: false`}),`.`]}),_jsxs(Expandable,{title:`entity fields`,children:[_jsxs(ResponseField,{name:`entity.key`,type:`string`,id:`param-entity-key`,children:[`Canonical entity key, e.g., `,_jsx(_components.code,{children:`anthropic`}),`.`]}),_jsx(ResponseField,{name:`entity.name`,type:`string`,id:`param-entity-name`,children:`Display name.`}),_jsxs(ResponseField,{name:`entity.type`,type:`string`,id:`param-entity-type`,children:[_jsx(_components.code,{children:`public_company`}),` · `,_jsx(_components.code,{children:`private_company`}),` · `,_jsx(_components.code,{children:`subsidiary`}),` · `,_jsx(_components.code,{children:`industry`}),` · `,_jsx(_components.code,{children:`sec_ticker_fallback`}),` · `,_jsx(_components.code,{children:`discovered_entity`})]}),_jsx(ResponseField,{name:`entity.ticker`,type:`string | null`,id:`param-entity-ticker`,children:`Stock ticker (public companies only).`}),_jsx(ResponseField,{name:`entity.sector`,type:`string | null`,id:`param-entity-sector`,children:`Industry sector.`}),_jsx(ResponseField,{name:`entity.industry`,type:`string | null`,id:`param-entity-industry`,children:`Specific industry.`}),_jsxs(ResponseField,{name:`entity.publicUrl`,type:`string | null`,id:`param-entity-public-url`,children:[`SEO-indexed public page at `,_jsx(_components.code,{children:`getbeta.io/company/{slug}`}),`.`]})]})]}),`\n`,_jsxs(ResponseField,{name:`resolution`,type:`object`,id:`param-resolution`,children:[_jsxs(_components.p,{children:[`Provenance metadata — see `,_jsx(_components.a,{href:`/citation-contract#the-grammar`,children:`Citation Contract`}),`.`]}),_jsxs(Expandable,{title:`resolution fields`,children:[_jsx(ResponseField,{name:`resolution.source`,type:`string`,id:`param-resolution-source`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`curated`}),` (registry hit) · `,_jsx(_components.code,{children:`discovered`}),` (LLM-discovered cache) · `,_jsx(_components.code,{children:`sec_fallback`}),` (ticker-only match) · `,_jsx(_components.code,{children:`symbol_fallback`}),` (symbol + industry) · `,_jsx(_components.code,{children:`disambiguation`}),` (resolved ambiguous name)`]})}),_jsx(ResponseField,{name:`resolution.confidence`,type:`number`,id:`param-resolution-confidence`,children:`Confidence in the resolution (0–1).`})]})]}),`\n`,_jsx(ResponseField,{name:`message`,type:`string | null`,id:`param-message`,children:_jsxs(_components.p,{children:[`Present when `,_jsx(_components.code,{children:`verified: false`}),` — explanation, e.g., `,_jsx(_components.code,{children:`\"Company not found in database\"`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`code-samples`,children:`Code samples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`curl`,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://api.getbeta.io/api/v1/validate \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer $BETA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{\"company\": \"Anthropic\"}'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`9`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` res = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` fetch(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.getbeta.io/api/v1/validate'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` method: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` headers: {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Bearer ${process.env.BETA_API_KEY}`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'application/json'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` body: JSON.stringify({ company: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Anthropic'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` data = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` res.json();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`7`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os, requests`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`res = requests.post(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.getbeta.io/api/v1/validate'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` headers={`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer {os.environ[\"BETA_API_KEY\"]}'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` json={`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'company'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Anthropic'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data = res.json()`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`live-response`,children:`Live response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"confidence\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"entity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anthropic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Anthropic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"private_company\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ticker\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sector\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"industry\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"technology\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"publicUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://getbeta.io/company/anthropic\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"curated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"confidence\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Body`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Company name required\"}`})}),_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`company`}),` field`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Company name must be 2-200 characters\"}`})}),_jsx(_components.td,{children:`Length out of range`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"API key required\"}`})}),_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`Authorization`}),` header`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Invalid API key\"}`})}),_jsx(_components.td,{children:`Key not found or revoked`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Daily rate limit exceeded\"}`})}),_jsxs(_components.td,{children:[`Per-tier limit hit (see `,_jsx(_components.a,{href:`/pricing`,children:`Pricing`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`citation-pointer`,children:`Citation pointer`}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/citation-contract`,children:`Citation Contract`}),` for how `,_jsx(_components.code,{children:`resolution.source`}),` and `,_jsx(_components.code,{children:`resolution.confidence`}),` are populated — and why `,_jsx(_components.code,{children:`verified: true`}),` with `,_jsx(_components.code,{children:`resolution.source: \"sec_fallback\"`}),` is not the same trust signal as `,_jsx(_components.code,{children:`resolution.source: \"curated\"`}),`.`]})]})}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":"POST /validate","description":"Resolve a company string to a canonical entity.","api":"POST https://api.getbeta.io/api/v1/validate","href":"/endpoints/validate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Use case","slug":"use-case","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Code samples","slug":"code-samples","depth":2,"children":[]},{"title":"Live response","slug":"live-response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Citation pointer","slug":"citation-pointer","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"POST /validate","path":"/api/v1/validate","servers":[{"url":"https://api.getbeta.io"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"company":[{"type":"string","description":"Company name to validate. Must be 2–200 characters.","required":true}]}}],"examples":{"example":{"value":{"company":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"verified":[{"type":"boolean","description":"`true` if BETA resolved the input. Always check `resolution.confidence` alongside this — `verified: true` with low confidence means a fuzzy/fallback match, not a confident one."}],"confidence":[{"type":"number","description":"Confidence score (0–1) for the entity match."}],"entity":[{"type":"object","properties":{"entity.key":[{"type":"string","description":"Canonical entity key, e.g., `anthropic` ."}],"entity.name":[{"type":"string","description":"Display name."}],"entity.type":[{"type":"string","description":"`public_company` · `private_company` · `subsidiary` · `industry` · `sec_ticker_fallback` · `discovered_entity`"}],"entity.ticker":[{"type":"object","properties":{},"description":"Stock ticker (public companies only)."}],"entity.sector":[{"type":"object","properties":{},"description":"Industry sector."}],"entity.industry":[{"type":"object","properties":{},"description":"Specific industry."}],"entity.publicUrl":[{"type":"object","properties":{},"description":"SEO-indexed public page at `getbeta.io/company/{slug}` ."}]},"description":"Canonical entity record. `null` when `verified: false` ."}],"resolution":[{"type":"object","properties":{"resolution.source":[{"type":"string","description":"`curated` (registry hit) · `discovered` (LLM-discovered cache) · `sec_fallback` (ticker-only match) · `symbol_fallback` (symbol + industry) · `disambiguation` (resolved ambiguous name)"}],"resolution.confidence":[{"type":"number","description":"Confidence in the resolution (0–1)."}]},"description":"Provenance metadata — see Citation Contract ."}],"message":[{"type":"object","properties":{},"description":"Present when `verified: false` — explanation, e.g., `\"Company not found in database\"` ."}]}}],"examples":{"example":{"value":{"verified":true,"confidence":123,"entity":{"entity.key":"\u003cstring>","entity.name":"\u003cstring>","entity.type":"\u003cstring>","entity.ticker":{},"entity.sector":{},"entity.industry":{},"entity.publicUrl":{}},"resolution":{"resolution.source":"\u003cstring>","resolution.confidence":123},"message":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"caliko","siteName":"BETA","title":"POST /validate - BETA","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-20T04:05:24.014Z","originalFileLocation":"endpoints/validate.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=\"Resolve a company string to a canonical entity.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BETA\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_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/caliko/972NRDDlJPNRzFoq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"POST /validate - BETA\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve a company string to a canonical entity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BETA\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.getbeta.io/endpoints/validate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://caliko.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=POST+%2Fvalidate\u0026amp;description=Resolve+a+company+string+to+a+canonical+entity.\u0026amp;theme=4ae97e799c72f4662aabc878\u0026amp;signature=48a84302ee22ebb7adee5a00ec4a84c97fb45ce51ceff4b62a5b3a92c16e4684\">\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=\"POST /validate - BETA\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve a company string to a canonical entity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://caliko.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=POST+%2Fvalidate\u0026amp;description=Resolve+a+company+string+to+a+canonical+entity.\u0026amp;theme=4ae97e799c72f4662aabc878\u0026amp;signature=48a84302ee22ebb7adee5a00ec4a84c97fb45ce51ceff4b62a5b3a92c16e4684\">\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/caliko/972NRDDlJPNRzFoq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BETA\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0a0a0a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.getbeta.io/endpoints/validate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoints/validate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.getbeta.io/#organization\",\"name\":\"BETA\",\"url\":\"https://developers.getbeta.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/caliko/5uVqCNQGCH7130tf/logo/light.svg?fit=max\u0026auto=format\u0026n=5uVqCNQGCH7130tf\u0026q=85\u0026s=a3036b5706a49ebe4241b42ff35fca0e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.getbeta.io#website\",\"name\":\"BETA\",\"url\":\"https://developers.getbeta.io\",\"publisher\":{\"@id\":\"https://developers.getbeta.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.getbeta.io/endpoints/validate#webpage\",\"url\":\"https://developers.getbeta.io/endpoints/validate\",\"name\":\"POST /validate\",\"description\":\"Resolve a company string to a canonical entity.\",\"dateModified\":\"2026-05-20T04:05:24.014Z\",\"isPartOf\":{\"@id\":\"https://developers.getbeta.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.getbeta.io/endpoints/validate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.getbeta.io/endpoints/validate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"BETA\",\"item\":\"https://developers.getbeta.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST /validate\",\"item\":\"https://developers.getbeta.io/endpoints/validate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.getbeta.io/endpoints/validate#apireference\",\"headline\":\"POST /validate\",\"name\":\"POST /validate\",\"description\":\"Resolve a company string to a canonical entity.\",\"url\":\"https://developers.getbeta.io/endpoints/validate\",\"mainEntityOfPage\":{\"@id\":\"https://developers.getbeta.io/endpoints/validate#webpage\"},\"dateModified\":\"2026-05-20T04:05:24.014Z\",\"publisher\":{\"@id\":\"https://developers.getbeta.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.getbeta.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BETA\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"BETA\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/endpoints/validate.md","siteName":"BETA","nav":{"global":{"anchors":[{"anchor":"MCP on npm","icon":"box-archive","href":"https://www.npmjs.com/package/@getbeta/mcp"},{"anchor":"GitHub","icon":"github","href":"https://github.com/caliko-llc/getbeta-mcp"}]},"groups":[{"group":"Get started","pages":[{"title":"Welcome to BETA","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","description":"API key Bearer-token authentication.","href":"/authentication"}]},{"group":"Endpoints","pages":[{"title":"POST /validate","api":"POST https://api.getbeta.io/api/v1/validate","href":"/endpoints/validate"},{"title":"POST /enrich","description":"Firmographics + headline insight + SWOT + competitors + people + events.","api":"POST https://api.getbeta.io/api/v1/enrich","href":"/endpoints/enrich"},{"title":"POST /timeline","api":"POST https://api.getbeta.io/api/v1/timeline","href":"/endpoints/timeline"},{"title":"POST /corroborate","api":"POST https://api.getbeta.io/api/v1/corroborate","href":"/endpoints/corroborate"},{"title":"POST /people","api":"POST https://api.getbeta.io/api/v1/people","href":"/endpoints/people"}]},{"group":"Citation Contract","pages":[{"title":"Citation Contract","href":"/citation-contract"}]},{"group":"Recipes","pages":[{"title":"Ground a customer email","href":"/recipes/ground-customer-email"},{"title":"Corroborate before write","href":"/recipes/corroborate-before-write"},{"title":"Freshness + cache patterns","href":"/recipes/freshness-and-cache"}]},{"group":"Reference","pages":[{"title":"Pricing","href":"/pricing"},{"title":"Status","href":"/status"},{"title":"Changelog","href":"/changelog"},{"title":"Roadmap","href":"/roadmap"}]}]},"basePath":"","title":"POST /validate - BETA","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","Page-CqcDm2To.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js"]}