Introduction
OpenDecisions: equivalent of nutrition labels for education decisions. Documentation home.
OpenDecisions (Open Decisions Graph)
OpenDecisions is equivalent of nutrition labels for education decisions: a public, open dataset and schema that turns scattered, un-auditable college data into comparable, citeable, uncertainty-aware labels, so students, counselors, and builders can make better choices without false precision or black boxes.
This site is the documentation for the OpenDecisions schema (v1), API, and prototype. Whether you're evaluating the project, building on it, or integrating the API, start with the Overview for full context: the problem we're solving, who it's for, what we're building, and what we don't do.
What you'll find here
Overview
Full context: problem, idea, use cases, impact, and guardrails
Guides
Step-by-step walkthroughs for building with the API and schema
Schema Reference
JSON-LD types, vocabulary, and field reference
Formulas
Versioned formulas for derived indexes (DQI, CCI, AFuI, CRI, OVI, AFI, ACI)
API Reference
REST endpoints for institutions, programs, and more
Core concepts
- Schema version:
odg/v1, namespacehttps://schema.opendecisions.org/v1/ - Core entities: Institution, Program, AdmissionCycle, CohortStats, CostProfile, OutcomeStats, Source, DerivedIndex (decision labels)
- API: Read-only REST API with pagination; OpenAPI at
/api-docs(Swagger) on the API server - Principles: Provenance for every claim ("no source, no claim"); uncertainty and data quality first-class; safety by default (no small-cell data, no false precision)
Quick links
- Overview: Why we're building this and who it's for
- Getting started: Call the API and explore data
- Schema index: All types and vocabulary
- Field reference: Every field explained
- Index formulas (v1): How DQI, CCI, AFuI, CRI, OVI, AFI, ACI are computed
- API endpoints: List of v1 endpoints