Skip to content

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

NameTypeDescription
personIdstringId of the person in situation.people to check.
asOfDatedateDate on which to measure the person's age.
minAgenumberMinimum 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

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