Developers · Public API

Every reference price, programmatically.

Key-authenticated, tier-filtered JSON endpoints for partners and the public. Identify a card by its structural tuple or by graded-slab cert — the internal Renaiss item id is never accepted on this surface.

Apply for API access ✦ Open Swagger explorer OpenAPI spec (JSON)

At a glance

Base URL

https://renaiss-os-index-public-api.vercel.app

Auth

X-Api-Key + X-Api-Secret headers (partner), or none (public · per-IP).

Card identity

Structural tuple (set_name, item_no, variation, language) or a graded-slab cert.

Authentication

Partner endpoints authenticate with an API key — a public key_id paired with a secret. Send both as headers on every request:

X-Api-Key — your key id (public)
X-Api-Secret — your secret

The secret is shown once when the key is issued and is stored only as a hash on our side — keep it server-side and never ship it in a browser bundle. The public read endpoints need no key (they’re rate-limited per IP). A wrong key or secret returns 401.

Need a key? Apply for API access →

Example request

curl https://renaiss-os-index-public-api.vercel.app/v1/graded/PSA151238633 \
  -H "X-Api-Key: $RENAISS_KEY_ID" \
  -H "X-Api-Secret: $RENAISS_SECRET"

Tiers

Tier	Auth	Quota	p95	Freshness SLA
Partner	X-Api-Key + X-Api-Secret	1k–100k / day	< 300 ms	99.5% · 24h
Public	none (per-IP)	60 / min · 1000 / day per IP	< 800 ms (cached)	best-effort

Endpoints

GET/v1/index/item-by-no

Look up a card by its structural tuple. Returns every (grading_company, grade) tier we track for that card in that language.

set_name: required
item_no: required
variation: use "" for the base print
language: required · BCP-47 tag (cards in different languages are different products)

GET/v1/index/by-cert

Look up a single graded slab by its cert. Returns one price estimate.

grading_company: required · e.g. PSA
grade_id: required · e.g. PSA73628064

Public-tier responses return grading_company, grade, best_estimate, currency, confidence_tier, and freshness_days. Partner-tier adds the numeric confidence_score and contributing-source counts. Attribution (“Renaiss OS Index” + a link to the source page) is required when displaying a number publicly.

Full reference

The complete endpoint list, request/response schemas, and status codes live in the interactive Swagger explorer — try any call there, or pull the OpenAPI spec.