Skip to content

Someone min age

Ensure at least one person from a specified list meets a minimum age requirement as of a specified date.

Passes when at least one of the listed people has reached the minimum age on the given date. Fails when none of them has. Returns no result when none of the listed people is in situation.people.

API endpoint
POST /api/v1/checks/age/someone-min-age
Last reviewed
November 19, 2026

Parameters

NameTypeDescription
peopleIdsBDT.tStringListIds of the people in situation.people to consider. One of them meeting the age is enough.
asOfDatedateDate on which to measure ages.
minAgenumberMinimum age in whole years. A person exactly this age counts.

Inputs

The screener answers this check reads:

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

Examples

No one meets ageFails

Neither person is 60 or older on January 1, 2026, so the check fails.

Request
{
  "parameters": {
    "asOfDate": "2026-01-01",
    "minAge": 60,
    "peopleIds": [
      "p1",
      "p2"
    ]
  },
  "situation": {
    "people": [
      {
        "dateOfBirth": "1990-06-15",
        "id": "p1"
      },
      {
        "dateOfBirth": "1970-03-01",
        "id": "p2"
      }
    ]
  }
}

One person meets agePasses

One of the two people is 65 on January 1, 2026, which meets a minimum age of 60, so the check passes.

Request
{
  "parameters": {
    "asOfDate": "2026-01-01",
    "minAge": 60,
    "peopleIds": [
      "p1",
      "p2"
    ]
  },
  "situation": {
    "people": [
      {
        "dateOfBirth": "1990-06-15",
        "id": "p1"
      },
      {
        "dateOfBirth": "1960-03-01",
        "id": "p2"
      }
    ]
  }
}

Limitations

  • Uses dates of birth as given; they are not verified.
  • A listed person without a date of birth is treated as not meeting the age, so the check can fail when a date of birth is missing.

Sources