Education

LEARN glossary catalog (PG-backed, Phase 1 structural)

Return the glossary catalog as {terms: [...], total: N, source: "pg"|"empty"}.

Behavior:

  • PG-populated: returns rows from v114 learn_glossary via pg_get_glossary_terms(tier, category). source = "pg".
  • PG empty / unavailable: returns {terms: [], total: 0, source: "empty"}. The in-app renderer falls back to window.GLOSSARY so an empty response is a graceful "use client-side dict" signal, not an error.

No JSON fallback at the route layer — the source-of-truth IS static/js/glossary.ts (already in the page as window.GLOSSARY). Adding a server-side JSON fallback would couple two source families to a third (PG, JS, JSON) for no behavioral gain.

get/api/learn/glossary

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/learn/glossary
  • Auth: none declared

Query parameters

tierstring nullable

Optional tier filter — 'beginner', 'basic', 'detail', or 'core'. Omit to return the full 1,391-entry catalog.

categorystring nullable

Optional category slug filter (e.g. 'personal-finance', 'valuation'). Matches the GLOSSARY_CATEGORY mapping.

Response

Successful Response

totalinteger nullable
sourcestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.