Skip to content

Tax freeze income

Checks that the applicant's and spouse's gross yearly income is within Philadelphia's tax freeze limit: $33,500 for a single person or $41,500 for a married couple.

Reads the combined gross yearly income of the applicant and any spouse (applicantAndSpouseIncome) and passes when it is at or below $33,500 for a single person or $41,500 for a married couple. The married limit applies when the relationships list includes a spouse for the applicant. Returns no result when income is missing or negative, or when the relationships list or primaryPersonId is missing so it is unknown whether the applicant has a spouse; an empty relationships list means there is no spouse.

API endpoint
POST /api/v1/checks/income/tax-freeze-income
Last reviewed
November 19, 2026

Inputs

The screener answers this check reads:

FieldType
situation.applicantAndSpouseIncomenumber
situation.primaryPersonIdstring
situation.relationships[].personIdstring
situation.relationships[].relatedPersonIdstring
situation.relationships[].typestring

Examples

Married over limitFails

A married couple with $41,500.01 is just over the married limit, so the check fails.

Request
{
  "situation": {
    "applicantAndSpouseIncome": 41500.01,
    "primaryPersonId": "p1",
    "relationships": [
      {
        "personId": "p1",
        "relatedPersonId": "p2",
        "type": "spouse"
      }
    ]
  }
}

PassPasses

A single applicant with exactly $33,500 in yearly income is within the limit.

Request
{
  "situation": {
    "applicantAndSpouseIncome": 33500,
    "primaryPersonId": "p1",
    "relationships": []
  }
}

Limitations

  • Combined gross income is taken as given. The City decides which income counts from the documents submitted.
  • The married limit applies whenever a spouse is listed, wherever the spouse lives.
  • The limits are those on the City pages when they were checked; the City may change them.

Sources