Skip to content

Applicant or spouse min age

Checks the applicant or live-in spouse against a minimum age as of today. An empty relationships list means no spouse; omitted relationships mean unknown.

Passes when the applicant, or a spouse who lives in the same household, has reached the minimum age on the screening date. A spouse who lives elsewhere does not count. When one path cannot be decided, the check still passes if the other path passes, and otherwise returns no result. The applicant's path cannot be decided when their date of birth is missing. The spouse's path cannot be decided when the relationships list is missing, so it is unknown whether there is a spouse; when the spouse is old enough but whether they live in the household is not answered; or when they live in the household (or that is not answered) and their date of birth is missing. A spouse who lives elsewhere fails the spouse's path whatever their date of birth. Neither path can be decided when primaryPersonId is missing. An empty relationships list means there is no spouse.

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

Parameters

NameTypeDescription
minAgenumberMinimum age, in whole years, that the applicant or live-in spouse must have reached on the screening date.

Inputs

The screener answers this check reads:

FieldType
situation.people[].dateOfBirthdate
situation.people[].idstring
situation.primaryPersonIdstring
situation.relationships[].personIdstring
situation.relationships[].relatedPersonIdstring
situation.relationships[].typestring
situation.simpleChecks.spouseLivesInHouseholdboolean

Examples

Live in spousePasses

A younger applicant passes because their spouse, who lives with them, is over 65.

Request
{
  "parameters": {
    "minAge": 65
  },
  "situation": {
    "people": [
      {
        "dateOfBirth": "2000-01-01",
        "id": "p1"
      },
      {
        "dateOfBirth": "1940-01-01",
        "id": "p2"
      }
    ],
    "primaryPersonId": "p1",
    "relationships": [
      {
        "personId": "p1",
        "relatedPersonId": "p2",
        "type": "spouse"
      }
    ],
    "simpleChecks": {
      "spouseLivesInHousehold": true
    }
  }
}

PassPasses

An applicant born in 1940 meets a minimum age of 65.

Request
{
  "parameters": {
    "minAge": 65
  },
  "situation": {
    "people": [
      {
        "dateOfBirth": "1940-01-01",
        "id": "p1"
      }
    ],
    "primaryPersonId": "p1"
  }
}

Spouse lives elsewhereFails

The same applicant fails when the spouse over 65 does not live in the household.

Request
{
  "parameters": {
    "minAge": 65
  },
  "situation": {
    "people": [
      {
        "dateOfBirth": "2000-01-01",
        "id": "p1"
      },
      {
        "dateOfBirth": "1940-01-01",
        "id": "p2"
      }
    ],
    "primaryPersonId": "p1",
    "relationships": [
      {
        "personId": "p1",
        "relatedPersonId": "p2",
        "type": "spouse"
      }
    ],
    "simpleChecks": {
      "spouseLivesInHousehold": false
    }
  }
}

Limitations

  • Age is measured on the screening date, not on a date the program chooses.
  • Whether the spouse lives in the household is taken from the screener answer.

Sources