---
title: "Embed Value Score Card Json"
method: GET
path: "/api/v1/embed/value-score"
---

# Embed Value Score Card Json

`GET /api/v1/embed/value-score`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/v1/embed/value-score`
- Auth: none declared

Public JSON sibling to /embed/value-score.

Path: GET /api/v1/embed/value-score?tickers=&features=&education=&days=&streak=&community=&ref=<host>
Returns the canonical composite (score + level + all five
components) for the provided raw signals. Same shared rate limit
and ref hostname-shape gate as the HTML route.

## Query parameters

- `ref` string, nullable

## Response `200`

Successful Response

- EmbedValueScoreJSONResponse: `GET /api/v1/embed/value-score` — JSON sibling to the HTML Value Creation Score badge at /embed/value-score (SF-10 #17a, 2026-06-12). Public surface, no auth, same shared embed rate limit. Accepts the six anonymous raw-signal query params GET /api/value-score already accepts and computes the composite via the canonical services.value_score helpers — the score is user-keyed (Value Creation Score) and is not tier-gated anywhere, so the full component breakdown is exposed.
  - `score` number, required: Composite Value Creation Score, 0-100.
  - `level` string, required: Named level for the score (e.g. 'Growing Investor'), from the canonical services.value_score level map.
  - `level_color` string, nullable: Brand hex color for the level (closed server-side map).
  - `components` object, required: All five component scores 0-100: research_breadth / research_depth / education / consistency / community.
  - `deep_link` string, required: CTA URL — the Oxford Ledge root with ?ref attribution when provided.
  - `ref` string, nullable: Normalized embedding-host attribution (DNS-shape validated). Null when no ref param.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)