Skip to main content
GET
Get latest cached score for a company.
Cached-only score lookup. Returns the freshest stored record, or 404 if Kepler has never scored this domain.

When to use it

  • After a 202 from POST /v1/score — once GET /v1/jobs/{job_id} reports status: "complete", call this endpoint (or use the score_url the job response hands you) to fetch the fresh score. The Python and TypeScript SDKs do this automatically inside Kepler.score().
  • To re-render an existing UI without using a cold-call slot — calls to this endpoint count against your cached quota, not cold.

What it does NOT do

  • Trigger a cold run. Even with no cached record, you get 404, never a 60-second wait.
  • Respect the freshness window. It returns the latest record regardless of age. If you care about freshness, check the scored_at timestamp yourself or use POST /v1/score.

Example

Authorizations

X-API-Key
string
header
required

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.

Path Parameters

domain
string
required

Bare hostname. Strips a leading www. and any URL scheme automatically.

Response

Latest score.

domain
string
required
scored_at
string<date-time>
required
ki_rating
enum<string>
required
Available options:
KI-1+,
KI-1,
KI-2+,
KI-2,
KI-3,
KI-4,
KI-5
composite_score
number<float>
required
Required range: 0 <= x <= 100
buckets
object
required

The 4 KI buckets. Each is 0–100.

mode
string

Present and = sandbox only with a ki_test_ key.

scale_premium
number<float>

Up to ~12 pts for established mega-caps; up to ~6 pts for growth profile.

Required range: 0 <= x <= 12
rank
object
x_kepler
object

Caller-facing metadata. Stable across versions.