Financial aid appeal letter

Draft a financial aid appeal letter to a college financial aid office. Call this when a family needs to ask for a review of an award: income dropped, an expense appeared, another school offered more, or the FAFSA was wrong. Returns the letter, not advice on whether to appeal. Runs a 5-step drafting pipeline, so it is the most expensive tool here and the slowest, typically 30 to 60 seconds.

post/v1/tools/appeal

Request

  • Base URL: https://api.counselorai.app
  • URL: https://api.counselorai.app/v1/tools/appeal
  • 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.

counselorNamestring

Who the letter is from. The counselor stays the author; this tool drafts, it does not sign.

schoolNamestring

The institution the appeal goes to.

appealType'changed_circumstances' | 'financial_hardship' | 'competing_offer' | 'special_circumstances' | 'error_correction'

What the appeal rests on. changed_circumstances is income loss or a new expense since the FAFSA, competing_offer is a match request, special_circumstances asks for a Professional Judgment review, error_correction fixes bad data on the original filing. financial_hardship is a legacy alias for changed_circumstances.

currentAwardstring

What the school offered, as written on the award letter.

amountNeededstring

The gap being asked for.

keyDetailsstring required

The circumstances, in the counselor or family's own words. This is what the letter is built out of, so specifics beat summaries.

competingstring

A competing offer to cite, if there is one.

statusstring[]

Student circumstances the letter should carry without labeling them. homeless and housing_insecure are the same category.

length'short' | 'standard' | 'detailed'

Roughly 330, 440 or 560 words.

naturalnessinteger

How plainly the letter should read. 1 is formal institutional, 5 is conversational.

Response

Tool output

request_idstring
toolstring

Changes

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