Launch529: 529 plans and college costs

Find colleges and universities by name, in the US and 529-eligible schools abroad. Returns each school's id, location and annual published costs (tuition, room and board, books). Use get_school with the id for cost history and net price.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of the school's name, e.g. 'san diego state'"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Details for one US school by id: current sticker price, average net price, net price by family income, cost history since 2005, graduation rate and median earnings. Get the id from search_schools.

{
  "type": "object",
  "properties": {
    "school_id": {
      "type": "integer",
      "description": "The school's id from search_schools"
    }
  },
  "required": [
    "school_id"
  ],
  "additionalProperties": false
}

Project what college will cost and what to save. Give a US school id and the year the student starts. Returns the projected cost per year and in total, and the monthly amount that would fully fund it from today, assuming steady returns after the plan's fees.

{
  "type": "object",
  "properties": {
    "school_id": {
      "type": "integer",
      "description": "US school id from search_schools"
    },
    "start_year": {
      "type": "integer",
      "description": "First academic year, e.g. 2044 for the 2044-45 year"
    },
    "years": {
      "type": "integer",
      "description": "Years of undergraduate study. Default 4."
    },
    "current_savings": {
      "type": "number",
      "description": "Already saved, in US dollars. Default 0."
    },
    "monthly_contribution": {
      "type": "number",
      "description": "What is saved each month. Default 0."
    },
    "annual_return_percent": {
      "type": "number",
      "description": "Expected yearly return before fees as a percent. Default 6."
    },
    "housing": {
      "type": "string",
      "enum": [
        "on_campus",
        "off_campus"
      ],
      "description": "Where the student will live. Default on_campus."
    }
  },
  "required": [
    "school_id",
    "start_year"
  ],
  "additionalProperties": false
}

List state 529 savings plans, ranked by popularity and ratings, with fees, Morningstar and Saving For College ratings, state tax benefit and whether residents of other states can join. Filter by state, by plans anyone can open, by maximum yearly fee, or by minimum rating.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. 'UT'. Returns that state's plans."
    },
    "open_to_nonresidents": {
      "type": "boolean",
      "description": "Only plans that people from any state can open"
    },
    "max_fee_percent": {
      "type": "number",
      "description": "Highest yearly asset-based fee, in percent, e.g. 0.3"
    },
    "top_rated": {
      "type": "boolean",
      "description": "Only plans with a Morningstar medal or a 4.5+ Saving For College rating"
    },
    "direct_sold_only": {
      "type": "boolean",
      "description": "Only plans you can open yourself, without an advisor"
    },
    "limit": {
      "type": "integer",
      "description": "How many to return. Default 10, up to 30."
    }
  },
  "additionalProperties": false
}

Everything we know about one 529 plan: fees, minimums, investment options, ratings, state tax benefit, restrictions and features. Use the slug from list_529_plans, or the plan's name.

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "description": "A plan slug like 'my529-ut', or part of its name"
    }
  },
  "required": [
    "plan"
  ],
  "additionalProperties": false
}

Compare two to four 529 plans side by side on fees, ratings, tax benefit, minimums and who can join.

{
  "type": "object",
  "properties": {
    "plans": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 4,
      "description": "Plan slugs or names"
    }
  },
  "required": [
    "plans"
  ],
  "additionalProperties": false
}

Say whether a college expense is a qualified 529 expense (for example 'laptop', 'off-campus rent', 'gas', 'student health insurance') with the reason, based on IRS Publication 970.

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "description": "What the money was spent on"
    }
  },
  "required": [
    "description"
  ],
  "additionalProperties": false
}