College Financial API - Documentation

GET /

Get API information and available endpoints

Example Request

GET https://college-financial-api.gradtrack.workers.dev/

Response (200 OK)

{
  "name": "College Degree Cost API",
  "version": "2.0.0",
  "endpoints": {
    "/degree-cost": "Get cost for a single university",
    "/compare": "Compare costs across multiple universities",
    "/program-cost": "Get cost for a specific program/field of study"
  }
}

GET /degree-cost

Get the total cost of a degree for a single university

university

string (required)

Full name of the university (e.g., "MIT", "University of Florida")

degree

string (optional)

Degree level - default: "Bachelor"

years

integer (optional)

Number of years to complete the degree - default: 4

adjust_inflation

boolean (optional)

Adjust costs for inflation over the degree period - default: false

Example Request

GET https://college-financial-api.gradtrack.workers.dev/degree-cost?university=MIT&years=4&adjust_inflation=true

Response (200 OK)

{
  "university": "Massachusetts Institute of Technology",
  "degree": "Bachelor",
  "years": 4,
  "in_state_total": 348032,
  "out_of_state_total": 348032,
  "breakdown": {
    "tuition_in_state": 62484,
    "tuition_out_state": 62484,
    "room_board": 19922,
    "other_expenses": 4602
  },
  "inflation_adjusted": true
}

Try it: Test Endpoint

GET /compare

Compare costs across multiple universities (up to 10)

universities

string (required)

Comma-separated list of university names

degree

string (optional)

Degree level - default: "Bachelor"

years

integer (optional)

Number of years - default: 4

adjust_inflation

boolean (optional)

Adjust costs for inflation - default: false

Example Request

GET https://college-financial-api.gradtrack.workers.dev/compare?universities=MIT,Stanford,University%20of%20Florida

Response (200 OK)

{
  "degree": "Bachelor",
  "years": 4,
  "inflation_adjusted": false,
  "comparisons": [
    {
      "university": "University of Florida",
      "in_state_total": 99808,
      "out_of_state_total": 152328,
      "breakdown": { ... }
    }
  ],
  "cheapest_in_state": "University of Florida",
  "cheapest_out_state": "University of Florida"
}

Try it: Test Endpoint

GET /program-cost

Get cost for a specific program/field of study at a university

university

string (required)

Full name of the university

program

string (optional)

Field of study (e.g., "Computer Science", "Business")

degree

string (optional)

Degree level - default: "Bachelor"

years

integer (optional)

Number of years - default: 4

adjust_inflation

boolean (optional)

Adjust costs for inflation - default: false

Example Request

GET https://college-financial-api.gradtrack.workers.dev/program-cost?university=MIT&program=Computer%20Science

Response (200 OK)

{
  "university": "Massachusetts Institute of Technology",
  "program": "Computer Science",
  "degree": "Bachelor",
  "years": 4,
  "in_state_total": 348032,
  "out_of_state_total": 348032,
  "breakdown": { ... },
  "program_data": {
    "program_name": "Computer Science",
    "programs_available": true,
    "note": "Program-specific cost data may not be available..."
  },
  "inflation_adjusted": false
}

Try it: Test Endpoint