The primary scoring entry point. Returns the latest score for domain from cache when a stored record is within your tier’s freshness window, or starts a cold scoring job when no fresh record exists.
HTTP 200 — a cached score is available. Returned inline; ready to use.
HTTP 202 — no fresh record. The server has started a cold scoring run and returned a job_id. Poll GET /v1/jobs/{job_id} until status: "complete".
Cold scoring runs typically take 25–90 seconds end-to-end. They are billed when the job starts, not when you finish polling — abandoning a poll loop does not get you a refund.
Cached (200) — the dominant path. Most calls hit it; tier-determined freshness windows are designed so that customer traffic mostly reuses recent work.
Cold (202) — first time you’ve ever asked for domain, or the most recent record is older than your tier’s window.
The official SDK handles both shapes transparently. score() blocks until the score is ready, polling internally on the cold path.
from kepler_insights import Keplerk = Kepler(api_key="ki_live_...")score = k.score("stripe.com") # blocks up to 180s on coldprint(f"{score.domain}: {score.ki_rating} ({score.composite_score:.1f})")# Non-blocking — get the Job and poll yourself:job = k.start_score("acme-co.com")print(job.id)score = job.wait(timeout=240)
composite_score is 0–100, not 0–10. Easy mistake when reading.
scale_premium is a separate additive bonus (up to ~12 pts). It’s already applied to composite_score; the field is broken out so you can show “47.0 composite + 4.1 scale premium” if you want.
rank is computed against the full universe Kepler has ever scored, not just the active cohort. Use /v1/company/{domain}/cohort for sector-matched comparison.
x_kepler.cache_status is "cached" on every score body, including the one you fetch after a job completes — the fresh cold-pipeline result is written to cache before the response shape is constructed. The enum is reserved for a future sync-cold response shape; today only "cached" is emitted.
wait parameter is accepted but ignored. Cold = async, always. The parameter is preserved so older client code doesn’t break.
ki_test_ keys against the 4 canned domains (acme.test, unicorn.test, struggling.test, cohort.test) always return inline 200. Sandbox has no cold path — there’s nothing to queue. This means production code paths that branch on 202 won’t be exercised in the sandbox. Test the polling path against a fresh live domain in staging before relying on it.
Live keys are prefixed ki_live_, test keys ki_test_. Issue + revoke
keys at https://console.keplerinsights.us. Never embed a key in client-side
code — every endpoint is backend-to-API only.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Kepler Insights API","colors":{"primary":"#C9A14A","light":"#E4C674","dark":"#0A0A0C"},"favicon":"https://mintcdn.com/keplerinsights/ZTgFXTcbaO0TLcCw/favicon.png?fit=max\u0026auto=format\u0026n=ZTgFXTcbaO0TLcCw\u0026q=85\u0026s=a56b8bf98d5f136f7d88e8ec3ed5f8a6","logo":{"light":"https://mintcdn.com/keplerinsights/ZTgFXTcbaO0TLcCw/logo-light.png?fit=max\u0026auto=format\u0026n=ZTgFXTcbaO0TLcCw\u0026q=85\u0026s=1ca58b0411b659002b06cfbde97ecf9e","dark":"https://mintcdn.com/keplerinsights/ZTgFXTcbaO0TLcCw/logo-dark.png?fit=max\u0026auto=format\u0026n=ZTgFXTcbaO0TLcCw\u0026q=85\u0026s=b8a5d5669b29c20821ce43abe89a514d"},"api":{"openapi":"openapi.yaml"},"background":{"decoration":null,"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"label":"Support","href":"mailto:team@keplerinsights.us"}],"primary":{"type":"button","label":"Get an API key","href":"https://console.keplerinsights.us"}},"seo":{"metatags":{"og:title":"Kepler Insights API","og:description":"Curated company-scoring intelligence over a 67-signal engine."},"indexing":"navigable"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"keplerinsights","hasAudioNarration":false,"actualSubdomain":"keplerinsights","customDomains":["docs.keplerinsights.us"],"gitSource":{"type":"github","owner":"nj1411","repo":"kepler-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21b794afa954dfcfc48801","collectionId":"fab5835a-e696-4658-8bab-e029b5aa891d","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95778a79c9948d24bd8e0:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API reference","count":11},{"language":"default","tag":"Endpoints","count":11},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Get started","count":7},{"language":"default","tag":"Resources","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":"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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"endpoints/score","slug":"/endpoints/score","pageMetadata":{"title":"POST /v1/score","openapi":"POST /v1/score","description":"Score a company. Cached returns inline; cold returns a job to poll.","href":"/endpoints/score"},"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: \"Score a company. Cached returns inline; cold returns a job to poll.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The primary scoring entry point. Returns the latest score for `,_jsx(_components.code,{children:`domain`}),` from cache when a stored record is within your tier’s freshness window, `,_jsx(_components.strong,{children:`or starts a cold scoring job`}),` when no fresh record exists.`]}),`\n`,_jsx(Heading,{level:`2`,id:`two-response-shapes`,children:`Two response shapes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`HTTP 200`}),` — a cached score is available. Returned inline; ready to use.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`HTTP 202`}),` — no fresh record. The server has started a cold scoring run and returned a `,_jsx(_components.code,{children:`job_id`}),`. Poll `,_jsx(_components.a,{href:`/endpoints/jobs`,children:_jsx(_components.code,{children:`GET /v1/jobs/{job_id}`})}),` until `,_jsx(_components.code,{children:`status: \"complete\"`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Cold scoring runs typically take `,_jsx(_components.strong,{children:`25–90 seconds`}),` end-to-end. They are billed when the job starts, not when you finish polling — abandoning a poll loop does not get you a refund.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-you’ll-see-each-path`,children:`When you’ll see each path`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cached (200) — the dominant path. Most calls hit it; tier-determined freshness windows are designed so that customer traffic mostly reuses recent work.`}),`\n`,_jsxs(_components.li,{children:[`Cold (202) — first time you’ve ever asked for `,_jsx(_components.code,{children:`domain`}),`, or the most recent record is older than your tier’s window.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Your tier’s freshness window:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tier`}),_jsx(_components.th,{children:`Window`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Free`}),_jsx(_components.td,{children:`7 days (sandbox only — Free can’t run live cold)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Starter`}),_jsx(_components.td,{children:`24 hours`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Growth`}),_jsx(_components.td,{children:`6 hours`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Scale`}),_jsx(_components.td,{children:`1 hour`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enterprise`}),_jsx(_components.td,{children:`15 minutes`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-python-sdk`,children:`Example (Python SDK)`}),`\n`,_jsxs(_components.p,{children:[`The official SDK handles both shapes transparently. `,_jsx(_components.code,{children:`score()`}),` blocks until the score is ready, polling internally on the cold path.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` kepler_insights `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Kepler`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`k `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Kepler(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ki_live_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`score `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` k.score(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"stripe.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# blocks up to 180s on cold`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`score.domain`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`score.ki_rating`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`score.composite_score`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:.1f}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`)\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Non-blocking — get the Job and poll yourself:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`job `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` k.start_score(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"acme-co.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(job.id)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`score `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` job.wait(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`240`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-curl-manual-polling`,children:`Example (curl, manual polling)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,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:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 1. Submit`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.keplerinsights.us/v1/score`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: ki_live_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"domain\":\"stripe.com\"}'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Cached response (200):`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# { \"domain\": \"stripe.com\", \"ki_rating\": \"KI-1\", \"composite_score\": 73.65, ... }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Cold response (202):`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# { \"job_id\": \"679a9e32-...\", \"status\": \"pending\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# \"domain\": \"stripe.com\", \"poll_url\": \"/v1/jobs/679a9e32-...\" }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 2. Poll until terminal (cold only)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.keplerinsights.us/v1/jobs/679a9e32-...`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: ki_live_...\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Branch on the response: if the body has `,_jsx(_components.code,{children:`composite_score`}),`, you have the score inline. If it has `,_jsx(_components.code,{children:`job_id`}),`, queue a poll loop on the `,_jsx(_components.code,{children:`poll_url`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`field-notes`,children:`Field notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`composite_score`})}),` is 0–100, `,_jsx(_components.strong,{children:`not 0–10.`}),` Easy mistake when reading.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`scale_premium`})}),` is a separate additive bonus (up to ~12 pts). It’s already applied to `,_jsx(_components.code,{children:`composite_score`}),`; the field is broken out so you can show “47.0 composite + 4.1 scale premium” if you want.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`rank`})}),` is computed against the full universe Kepler has ever scored, not just the active cohort. Use `,_jsx(_components.a,{href:`/endpoints/cohort`,children:_jsx(_components.code,{children:`/v1/company/{domain}/cohort`})}),` for sector-matched comparison.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`x_kepler.cache_status`})}),` is `,_jsx(_components.code,{children:`\"cached\"`}),` on every score body, including the one you fetch after a job completes — the fresh cold-pipeline result is written to cache before the response shape is constructed. The enum is reserved for a future sync-cold response shape; today only `,_jsx(_components.code,{children:`\"cached\"`}),` is emitted.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`wait`}),` parameter`]}),` is accepted but ignored. Cold = async, always. The parameter is preserved so older client code doesn’t break.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`sandbox-behavior`,children:`Sandbox behavior`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ki_test_`}),` keys against the 4 canned domains (`,_jsx(_components.code,{children:`acme.test`}),`, `,_jsx(_components.code,{children:`unicorn.test`}),`, `,_jsx(_components.code,{children:`struggling.test`}),`, `,_jsx(_components.code,{children:`cohort.test`}),`) always return inline 200. Sandbox has no cold path — there’s nothing to queue. This means production code paths that branch on 202 won’t be exercised in the sandbox. Test the polling path against a fresh live domain in staging before relying on it.`]})]})}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 /v1/score","openapi":"POST /v1/score","description":"Score a company. Cached returns inline; cold returns a job to poll.","href":"/endpoints/score"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Two response shapes","slug":"two-response-shapes","depth":2,"children":[]},{"title":"When you’ll see each path","slug":"when-you’ll-see-each-path","depth":2,"children":[]},{"title":"Example (Python SDK)","slug":"example-python-sdk","depth":2,"children":[]},{"title":"Example (curl, manual polling)","slug":"example-curl-manual-polling","depth":2,"children":[]},{"title":"Field notes","slug":"field-notes","depth":2,"children":[]},{"title":"Sandbox behavior","slug":"sandbox-behavior","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["scoring"],"summary":"Score a company. Cached returns inline, cold returns a job.","description":"Score a company. Cached returns inline; cold returns a job to poll.","operationId":"scoreCompany","requestBody":"51e7ea8e-c98e-4bfb-9457-da67d545c7cb","responses":{"200":"4db24523-5888-4e93-8bc2-8428e09a06fd","202":"6397f626-878e-47b8-8f58-ba6e325e2e97","400":"0a84cc50-ec8b-4e45-a12a-1aaaff5d3356","401":"679eff02-08fb-46a0-93b1-1d3beec86f47","403":"4a149e32-5b30-45f8-a9e5-254c31ebb6f1","429":"8c440482-3daf-4101-826d-950dfc0845d4","500":"3130f7a2-3892-4040-9506-d4e935cc4b55"},"method":"post","type":"path","servers":["4ac1ac92-e288-4492-8822-b3268e7550b6"],"security":["589394a0-540d-4375-8376-7e5d22b1df50"],"path":"/v1/score","baseUrlOptions":["https://api.keplerinsights.us"],"title":"Score a company. Cached returns inline, cold returns a job.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","example":"stripe.com","isRequired":true,"uniqueKey":"domain","typeLabel":"string"},"force_fresh":{"type":"boolean","description":"Enterprise-only. Forces a cold run even if a fresh record exists.","default":false,"uniqueKey":"force_fresh","typeLabel":"boolean"},"wait":{"type":"boolean","description":"Accepted for backwards compatibility, ignored. Cold is always async.","default":true,"deprecated":true,"uniqueKey":"wait","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domain":"stripe.com","force_fresh":false,"wait":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4db24523-5888-4e93-8bc2-8428e09a06fd":{"description":"Cached score (fresh under your tier's window).","content":{"application/json":{"schema":{"type":"object","required":["domain","scored_at","ki_rating","composite_score","buckets"],"properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"domain","typeLabel":"string"},"scored_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"scored_at","typeLabel":"string\u003cdate-time>"},"ki_rating":{"type":"string","enum":["KI-1+","KI-1","KI-2+","KI-2","KI-3","KI-4","KI-5"],"isRequired":true,"uniqueKey":"ki_rating","typeLabel":"enum\u003cstring>"},"composite_score":{"type":"number","format":"float","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"composite_score","typeLabel":"number\u003cfloat>"},"buckets":{"type":"object","description":"The 4 KI buckets. Each is 0–100.","properties":{"team_structure":{"type":"number","format":"float","minimum":0,"maximum":100,"uniqueKey":"buckets.team_structure","typeLabel":"number\u003cfloat>"},"market_position":{"type":"number","format":"float","minimum":0,"maximum":100,"uniqueKey":"buckets.market_position","typeLabel":"number\u003cfloat>"},"momentum_tailwinds":{"type":"number","format":"float","minimum":0,"maximum":100,"uniqueKey":"buckets.momentum_tailwinds","typeLabel":"number\u003cfloat>"},"financial_health":{"type":"number","format":"float","minimum":0,"maximum":100,"uniqueKey":"buckets.financial_health","typeLabel":"number\u003cfloat>"}},"isRequired":true,"uniqueKey":"buckets","typeLabel":"object"},"mode":{"type":"string","description":"Present and = `sandbox` only with a ki_test_ key.","uniqueKey":"mode","typeLabel":"string"},"scale_premium":{"type":"number","format":"float","minimum":0,"maximum":12,"description":"Up to ~12 pts for established mega-caps; up to ~6 pts for growth profile.","uniqueKey":"scale_premium","typeLabel":"number\u003cfloat>"},"rank":{"type":"object","properties":{"percentile":{"type":"integer","minimum":0,"maximum":100,"uniqueKey":"rank.percentile","typeLabel":"integer"},"cohort_size":{"type":"integer","minimum":0,"uniqueKey":"rank.cohort_size","typeLabel":"integer"}},"uniqueKey":"rank","typeLabel":"object"},"x_kepler":{"type":"object","description":"Caller-facing metadata. Stable across versions.","properties":{"tier":{"type":"string","enum":["free","starter","growth","scale","enterprise"],"uniqueKey":"x_kepler.tier","typeLabel":"enum\u003cstring>"},"cache_status":{"type":"string","enum":["cached"],"description":"Today only `cached` is emitted — fresh cold-pipeline results are written to cache before the response is constructed. The enum is reserved for a future sync-cold response shape.","uniqueKey":"x_kepler.cache_status","typeLabel":"enum\u003cstring>"},"freshness_window_hours":{"type":"number","uniqueKey":"x_kepler.freshness_window_hours","typeLabel":"number"}},"uniqueKey":"x_kepler","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domain":"\u003cstring>","scored_at":"2023-11-07T05:31:56Z","ki_rating":"KI-1+","composite_score":50,"buckets":{"team_structure":50,"market_position":50,"momentum_tailwinds":50,"financial_health":50},"mode":"\u003cstring>","scale_premium":6,"rank":{"percentile":50,"cohort_size":1},"x_kepler":{"tier":"free","cache_status":"cached","freshness_window_hours":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"6397f626-878e-47b8-8f58-ba6e325e2e97":{"description":"Cold scoring job started. Poll `poll_url` until complete.","content":{"application/json":{"schema":{"type":"object","required":["job_id","status","domain","poll_url"],"properties":{"job_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"job_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"domain":{"type":"string","isRequired":true,"uniqueKey":"domain","typeLabel":"string"},"poll_url":{"type":"string","example":"/v1/jobs/9f0c…","isRequired":true,"uniqueKey":"poll_url","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"job_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","domain":"\u003cstring>","poll_url":"/v1/jobs/9f0c…"}}},"exampleType":"generated"}},"exampleType":"generated"},"0a84cc50-ec8b-4e45-a12a-1aaaff5d3356":{"description":"Validation error (missing or malformed domain).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"reason":{"type":"string","description":"Additional context for rate-limit responses.","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"679eff02-08fb-46a0-93b1-1d3beec86f47":{"description":"Missing or invalid `X-API-Key`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"reason":{"type":"string","description":"Additional context for rate-limit responses.","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4a149e32-5b30-45f8-a9e5-254c31ebb6f1":{"description":"Free trial — live scoring not included. Use a `ki_test_` key, or upgrade.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"reason":{"type":"string","description":"Additional context for rate-limit responses.","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8c440482-3daf-4101-826d-950dfc0845d4":{"description":"Rate-limit response. `error` distinguishes the cause:\n- `cold_budget_exhausted` — monthly cold-call cap hit. Retry-After is seconds until the next monthly reset.\n- `rate limited` (`reason: per_key_cold_1h`) — 200-cold-calls-per-hour-per-key breaker.\n- `rate limited` (`reason: account_cold_24h`) — 2× tier monthly cap inside any 24h window.\n","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until you can retry."}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"reason":{"type":"string","description":"Additional context for rate-limit responses.","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3130f7a2-3892-4040-9506-d4e935cc4b55":{"description":"Scoring engine unavailable (pipeline or job tracking failure).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"reason":{"type":"string","description":"Additional context for rate-limit responses.","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"\u003cstring>","reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"589394a0-540d-4375-8376-7e5d22b1df50":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Live keys are prefixed `ki_live_`, test keys `ki_test_`. Issue + revoke\nkeys at https://console.keplerinsights.us. Never embed a key in client-side\ncode — every endpoint is backend-to-API only.\n","scopes":[]}}},"servers":{"4ac1ac92-e288-4492-8822-b3268e7550b6":{"url":"https://api.keplerinsights.us","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Live keys are prefixed `ki_live_`, test keys `ki_test_`. Issue + revoke\nkeys at https://console.keplerinsights.us. Never embed a key in client-side\ncode — every endpoint is backend-to-API only.\n","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Live keys are prefixed `ki_live_`, test keys `ki_test_`. Issue + revoke\nkeys at https://console.keplerinsights.us. Never embed a key in client-side\ncode — every endpoint is backend-to-API only.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"keplerinsights","siteName":"Kepler Insights API","title":"Kepler Insights API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-14T15:47:23.477Z","originalFileLocation":"endpoints/score.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=\"Score a company. Cached returns inline; cold returns a job to poll.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kepler Insights API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_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/keplerinsights/eV34f5WX0CNZZw-V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Kepler Insights API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Curated company-scoring intelligence over a 67-signal engine.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kepler Insights API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.keplerinsights.us/endpoints/score\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://keplerinsights.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=POST+%2Fv1%2Fscore\u0026amp;description=Score+a+company.+Cached+returns+inline%3B+cold+returns+a+job+to+poll.\u0026amp;theme=b92031ae73fe8f3570cd08c2\u0026amp;signature=940f7ac69729f8a9cb31bf92ec86e725742ad290ce134739d4694f75c5a1de0d\">\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=\"Kepler Insights API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Curated company-scoring intelligence over a 67-signal engine.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://keplerinsights.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=POST+%2Fv1%2Fscore\u0026amp;description=Score+a+company.+Cached+returns+inline%3B+cold+returns+a+job+to+poll.\u0026amp;theme=b92031ae73fe8f3570cd08c2\u0026amp;signature=940f7ac69729f8a9cb31bf92ec86e725742ad290ce134739d4694f75c5a1de0d\">\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/keplerinsights/eV34f5WX0CNZZw-V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kepler Insights API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C9A14A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.keplerinsights.us/endpoints/score\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoints/score.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.keplerinsights.us/#organization\",\"name\":\"Kepler Insights API\",\"url\":\"https://docs.keplerinsights.us\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/keplerinsights/ZTgFXTcbaO0TLcCw/logo-light.png?fit=max\u0026auto=format\u0026n=ZTgFXTcbaO0TLcCw\u0026q=85\u0026s=1ca58b0411b659002b06cfbde97ecf9e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.keplerinsights.us#website\",\"name\":\"Kepler Insights API\",\"url\":\"https://docs.keplerinsights.us\",\"publisher\":{\"@id\":\"https://docs.keplerinsights.us/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.keplerinsights.us/endpoints/score#webpage\",\"url\":\"https://docs.keplerinsights.us/endpoints/score\",\"name\":\"POST /v1/score\",\"description\":\"Score a company. Cached returns inline; cold returns a job to poll.\",\"dateModified\":\"2026-05-14T15:47:23.477Z\",\"isPartOf\":{\"@id\":\"https://docs.keplerinsights.us#website\"},\"breadcrumb\":{\"@id\":\"https://docs.keplerinsights.us/endpoints/score#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.keplerinsights.us/endpoints/score#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Kepler Insights API\",\"item\":\"https://docs.keplerinsights.us\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST /v1/score\",\"item\":\"https://docs.keplerinsights.us/endpoints/score\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.keplerinsights.us/endpoints/score#apireference\",\"headline\":\"POST /v1/score\",\"name\":\"POST /v1/score\",\"description\":\"Score a company. Cached returns inline; cold returns a job to poll.\",\"url\":\"https://docs.keplerinsights.us/endpoints/score\",\"mainEntityOfPage\":{\"@id\":\"https://docs.keplerinsights.us/endpoints/score#webpage\"},\"dateModified\":\"2026-05-14T15:47:23.477Z\",\"publisher\":{\"@id\":\"https://docs.keplerinsights.us/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.keplerinsights.us#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kepler Insights API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kepler Insights API","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API reference","icon":"code","groups":[{"group":"Endpoints","pages":[{"title":"POST /v1/score","openapi":"POST /v1/score","href":"/endpoints/score"},{"title":"GET /v1/score/{domain}","openapi":"GET /v1/score/{domain}","description":"Read the latest cached score for a company. Never triggers a cold run.","href":"/endpoints/score-get"},{"title":"Async scoring","href":"/endpoints/async"},{"title":"GET /v1/jobs/{job_id}","openapi":"GET /v1/jobs/{job_id}","href":"/endpoints/jobs"},{"title":"GET /v1/score/{domain}/history","openapi":"GET /v1/score/{domain}/history","href":"/endpoints/history"},{"title":"GET /v1/company/{domain}/cohort","openapi":"GET /v1/company/{domain}/cohort","href":"/endpoints/cohort"},{"title":"GET /v1/company/{domain}/confidence","openapi":"GET /v1/company/{domain}/confidence","href":"/endpoints/confidence"},{"title":"GET /v1/distribution","openapi":"GET /v1/distribution","href":"/endpoints/distribution"},{"title":"GET /v1/movers","openapi":"GET /v1/movers","href":"/endpoints/movers"},{"title":"GET /v1/signals","openapi":"GET /v1/signals","href":"/endpoints/signals"},{"title":"GET /v1/usage","openapi":"GET /v1/usage","href":"/endpoints/usage"}]}]},{"anchor":"Developer console","href":"https://console.keplerinsights.us","icon":"key"}]},"basePath":"","title":"Kepler Insights API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}