Applicant or spouse min age
Checks the applicant or live-in spouse against a minimum age as of today. An empty relationships list means no spouse; omitted relationships mean unknown.
Passes when the applicant, or a spouse who lives in the same household, has reached the minimum age on the screening date. A spouse who lives elsewhere does not count. When one path cannot be decided, the check still passes if the other path passes, and otherwise returns no result. The applicant's path cannot be decided when their date of birth is missing. The spouse's path cannot be decided when the relationships list is missing, so it is unknown whether there is a spouse; when the spouse is old enough but whether they live in the household is not answered; or when they live in the household (or that is not answered) and their date of birth is missing. A spouse who lives elsewhere fails the spouse's path whatever their date of birth. Neither path can be decided when primaryPersonId is missing. An empty relationships list means there is no spouse.
- API endpoint
POST /api/v1/checks/age/applicant-or-spouse-min-age- Last reviewed
- November 19, 2026
Parameters
| Name | Type | Description |
|---|---|---|
minAge | number | Minimum age, in whole years, that the applicant or live-in spouse must have reached on the screening date. |
Inputs
The screener answers this check reads:
| Field | Type |
|---|---|
situation.people[].dateOfBirth | date |
situation.people[].id | string |
situation.primaryPersonId | string |
situation.relationships[].personId | string |
situation.relationships[].relatedPersonId | string |
situation.relationships[].type | string |
situation.simpleChecks.spouseLivesInHousehold | boolean |
Examples
Live in spousePasses
A younger applicant passes because their spouse, who lives with them, is over 65.
Request
{
"parameters": {
"minAge": 65
},
"situation": {
"people": [
{
"dateOfBirth": "2000-01-01",
"id": "p1"
},
{
"dateOfBirth": "1940-01-01",
"id": "p2"
}
],
"primaryPersonId": "p1",
"relationships": [
{
"personId": "p1",
"relatedPersonId": "p2",
"type": "spouse"
}
],
"simpleChecks": {
"spouseLivesInHousehold": true
}
}
}PassPasses
An applicant born in 1940 meets a minimum age of 65.
Request
{
"parameters": {
"minAge": 65
},
"situation": {
"people": [
{
"dateOfBirth": "1940-01-01",
"id": "p1"
}
],
"primaryPersonId": "p1"
}
}Spouse lives elsewhereFails
The same applicant fails when the spouse over 65 does not live in the household.
Request
{
"parameters": {
"minAge": 65
},
"situation": {
"people": [
{
"dateOfBirth": "2000-01-01",
"id": "p1"
},
{
"dateOfBirth": "1940-01-01",
"id": "p2"
}
],
"primaryPersonId": "p1",
"relationships": [
{
"personId": "p1",
"relatedPersonId": "p2",
"type": "spouse"
}
],
"simpleChecks": {
"spouseLivesInHousehold": false
}
}
}Limitations
- Age is measured on the screening date, not on a date the program chooses.
- Whether the spouse lives in the household is taken from the screener answer.
Sources
- Set up a Real Estate Tax Installment Plan (City of Philadelphia) (checked November 19, 2026)
- Benefit Decision Toolkit situation data model (BDT.dmn): tSituation: primaryPersonId, people, relationships, simpleChecks.spouseLivesInHousehold (checked November 19, 2026)