A financial assistance file for hospital websites

A small JSON file a hospital posts on its own site. It states who gets free or discounted care, how to apply and where the full policy lives. Patients' AI assistants can read it directly.

This is a new format proposed by HospitalAid, version 0.1. It is not an adopted industry standard. Anyone can use it for free, and we welcome comments from hospitals and developers at [email protected].

Why post it

  • Many policies are long PDFs. People and programs both find it hard to pull the income levels out of them.
  • A file you write yourself is the most direct source there is. Assistants and sites like ours can quote your own numbers with your own date.
  • Nonprofit hospitals already post the policy, a plain language summary and an application under IRS rule 501(r). This file points to those three and adds the key numbers.

Where it goes

Post the file at this address on your hospital's website.

https://<your-hospital-site>/.well-known/financial-assistance.json

The /.well-known/ folder is a common place for files that programs look for (RFC 8615). Names in that folder are meant to be registered with IANA. This name is not registered, so treat it as a proposed location for now. A health system can post one file per hospital site, or one file that lists every CCN the policy covers.

The fields

Only 5 fields are required (schema_version, hospital_name, ccns, policy_url, last_reviewed). Leave out any other field you do not know, or set it to null. Do not guess. Your written policy at policy_url is the final word.

FieldTypeRequiredMeaning
schema_versiontextYesVersion of this format. Use "0.1".
hospital_nametextYesThe hospital name patients know.
ccnslist of textYesCMS Certification Numbers (six characters) of every hospital this policy covers.
policy_nametextNoTitle of the written policy.
effective_datedateNoDate the current policy took effect (YYYY-MM-DD).
last_revieweddateYesDate the hospital last checked this file against its written policy (YYYY-MM-DD).
free_care_fpl_pctnumberNoCare is free when household income is at or below this percent of the federal poverty level. null if the policy has no free care level.
discount_care_fpl_pctnumberNoSome discount is given when household income is at or below this percent of the federal poverty level. null if there is no income-based discount.
discount_tierslist of stepsNoDiscount steps between the free care level and the discount level.
covers_insured_patientstrue or falseNotrue if insured patients can get help with deductibles, copays or coinsurance.
asset_testtrue or falseNotrue if the policy counts savings or property as well as income.
residency_requirementtextNoWho must live where to apply, in plain words. null if there is no residency rule.
catastrophic_provisiontextNoHelp for very large bills relative to income, in plain words. null if none.
application_deadline_dayswhole numberNoDays a patient has to apply, counted as the policy says. null if the policy sets no deadline.
documents_requiredlist of textNoDocuments a patient sends with the application.
languageslist of textNoLanguages the policy and application are offered in.
policy_urllinkYesLink to the full written policy.
application_urllinkNoLink to the application form.
plain_language_summary_urllinkNoLink to the plain language summary.
financial_counseling_phonetextNoPhone number for financial counseling or billing help.
financial_counseling_emailemailNoEmail for financial counseling or billing help.
notestextNoAnything a patient should know that has no field.

Each step in discount_tiers has these fields.

FieldMeaning
fpl_minLowest income in this step, as a percent of the poverty level.
fpl_maxHighest income in this step. null if there is no upper limit.
patient_paysWhat the patient pays in this step, in plain words.

Income levels are a percent of the federal poverty level, so a policy at 200% writes 200. The full rules are in the JSON Schema (draft 2020-12), at https://hospitalaid.org/standard/financial-assistance.schema.json.

An example

Example Community Hospital is made up. So are its CCN, phone number and links. You can download the example file and change it.

{
  "schema_version": "0.1",
  "hospital_name": "Example Community Hospital",
  "ccns": [
    "999999"
  ],
  "policy_name": "Financial Assistance Policy",
  "effective_date": "2026-07-01",
  "last_reviewed": "2026-11-01",
  "free_care_fpl_pct": 200,
  "discount_care_fpl_pct": 400,
  "discount_tiers": [
    {
      "fpl_min": 0,
      "fpl_max": 200,
      "patient_pays": "nothing"
    },
    {
      "fpl_min": 201,
      "fpl_max": 300,
      "patient_pays": "25% of charges"
    },
    {
      "fpl_min": 301,
      "fpl_max": 400,
      "patient_pays": "50% of charges"
    }
  ],
  "covers_insured_patients": true,
  "asset_test": false,
  "residency_requirement": null,
  "catastrophic_provision": "Bills over 20% of yearly household income are reduced to 20% of income",
  "application_deadline_days": 240,
  "documents_required": [
    "proof of income",
    "photo ID"
  ],
  "languages": [
    "English",
    "Spanish"
  ],
  "policy_url": "https://www.example.org/financial-assistance/policy.pdf",
  "application_url": "https://www.example.org/financial-assistance/application.pdf",
  "plain_language_summary_url": "https://www.example.org/financial-assistance/summary.pdf",
  "financial_counseling_phone": "(555) 555-0142",
  "financial_counseling_email": "[email protected]",
  "notes": "Payment plans with no interest are available for any bill."
}

Publish it in three steps

  1. Copy the example and fill it in from your current written policy. Set last_reviewed to today.
  2. Check it with any JSON Schema validator against https://hospitalaid.org/standard/financial-assistance.schema.json.
  3. Ask your web team to post it at /.well-known/financial-assistance.json on your main site, served as plain JSON. Update it whenever the policy changes.

Tell us when it is live

Email [email protected] with the link to your file. We read it, check it against your written policy and mark your page on HospitalAid verified, with the date and a link to your file as the source. There is no charge, and a hospital cannot pay to change what its page says.

See also how to claim your hospital's page and our open data.