Skip to content

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

NameTypeDescription
personIdstringId of the person in situation.people to check.
asOfDatedateDate on which to measure the person's age.
maxAgenumberMaximum age in whole years. A person exactly this age passes.

Inputs

The screener answers this check reads:

FieldType
situation.people[].dateOfBirthdate
situation.people[].idstring

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