Skip to content

Min years owner occupant

Checks that the applicant has owned and occupied the primary residence for at least the specified number of years.

Passes when the applicant has owned and lived in their primary residence for at least the minimum number of years. Returns no result when the number of years or the minYears parameter is missing or negative.

API endpoint
POST /api/v1/checks/residence/min-years-owner-occupant
Last reviewed
November 19, 2026

Parameters

NameTypeDescription
minYearsnumberMinimum number of years the applicant must have owned and lived in the home. Exactly this many years passes.

Inputs

The screener answers this check reads:

FieldType
situation.yearsOwnerOccupiednumber

Examples

FailFails

An applicant with 9.99 years in the home falls short of a 10-year minimum.

Request
{
  "parameters": {
    "minYears": 10
  },
  "situation": {
    "yearsOwnerOccupied": 9.99
  }
}

PassPasses

An applicant with exactly 10 years in the home meets a 10-year minimum.

Request
{
  "parameters": {
    "minYears": 10
  },
  "situation": {
    "yearsOwnerOccupied": 10
  }
}

Limitations

  • The number of years is taken from the screener answer, not from deed records.
  • Does not check whether time in the home was continuous.

Sources