Person max age
Checks that a specified person is no older than a maximum age on a specified date.
Passes when the person's age in whole years on the given date is at most the maximum age. Returns no result when the person or their date of birth is missing.
- API endpoint
POST /api/v1/checks/age/person-max-age- Last reviewed
- November 19, 2026
Parameters
| Name | Type | Description |
|---|---|---|
personId | string | Id of the person in situation.people to check. |
asOfDate | date | Date on which to measure the person's age. |
maxAge | number | Maximum age in whole years. A person exactly this age passes. |
Inputs
The screener answers this check reads:
| Field | Type |
|---|---|
situation.people[].dateOfBirth | date |
situation.people[].id | string |
Examples
age is below max agePasses
A child born on January 1, 2025 is under the maximum age of 5 on December 31, 2025.
Request
{
"parameters": {
"asOfDate": "2025-12-31",
"maxAge": 5,
"personId": "p1"
},
"situation": {
"people": [
{
"dateOfBirth": "2025-01-01",
"id": "p1"
}
]
}
}Limitations
- Uses the date of birth as given; it is not verified.
Sources
- Benefit Decision Toolkit situation data model (BDT.dmn): tSituation: people[].id, people[].dateOfBirth (checked November 19, 2026)