Person min age
Ensure a specified person's age meets a minimum number as of a specified date.
Passes when the person's age in whole years on the given date is at least the minimum age. Returns no result when the person or their date of birth is missing.
- API endpoint
POST /api/v1/checks/age/person-min-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. |
minAge | number | Minimum 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
Person At Min AgePasses
A person born on January 1, 2020 turns 4 on January 1, 2024, so they meet a minimum age of 4 on that date.
Request
{
"parameters": {
"asOfDate": "2024-01-01",
"minAge": 4,
"personId": "p1"
},
"situation": {
"people": [
{
"dateOfBirth": "2020-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)