FAFSA checklist

Produce a FAFSA action checklist for one student, keyed to their grade, dependency status and income band. Answers the process question a family actually has: what do we do, in what order, by when. Does not compute an award.

post/v1/tools/fafsa

Request

  • Base URL: https://api.counselorai.app
  • URL: https://api.counselorai.app/v1/tools/fafsa
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry-safe key. Guarantees the call is billed at most once.

X-Max-Creditsinteger

Maximum credits approved for this call. Rejects a larger hold and caps the final charge.

Request body

studentNamestring

The student this is about. Used in the output text.

grade'9' | '10' | '11' | '12' | 'transfer'

How far out the family is. 12 means act now.

dependency'dependent' | 'independent' | 'unsure'

Dependency drives whose income is reported. unsure is a valid answer and changes the checklist.

income'under30' | '30to60' | '60to100' | 'over100' | 'unknown'

Household income band. Drives whether Pell is in play.

specialsstring[]

Situations that change the filing rules: divorced or separated parents, a stepparent, a sibling also in college, undocumented status, foster care, housing instability, disability, a mid-year income change.

schoolsstring

Schools on the list, if known. Deadlines differ by school.

timelinestring

Where they are in the cycle.

notesstring

Anything else that should shape the output.

Response

Tool output

request_idstring
toolstring

Changes

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