Skip to navigation

List Certifications

List all affordable certifications

Authentication

x-api-keystring
API Key authentication via header

Response

A paged array of certifications
reviewStatusenumOptional
The review status of the certification
effectiveDatedateOptional
The date when the certification becomes effective
anticipatedDatedateOptional
The anticipated date for the certification, if applicable
nextRecertificationDatedateOptional
The next date for recertification, if applicable
contractNumberstringOptional
HUD contract number tied to the certification floor plan
typeenumOptional
Type of certification according to their respective affordable program
certificationTypestringOptional

Raw certification type as stored on the certification (e.g. RECERT, GROSS_RENT, MI, IR, AR)

currentStatusstringOptional
Current status of the certification
programstringOptional

Affordable program name of the certification (e.g. HUD, Tax Credit, Rural Development)

tenantNamestringOptional
Head of household name on the certification
unitNumberstringOptional
Unit number on the certification
dueDatedateOptional
Recertification due date for the certification
completionDatedatetimeOptional
Date the certification was completed
subsidyTypeenumOptional
Type of subsidy for the certification
Allowed values:
secondarySubsidyTypestringOptional
Secondary HUD subsidy type configured on the property
tenantPaymentAmountdoubleOptional
The amount the tenant is required to pay, in USD
assistancePaymentAmountdoubleOptional
The amount of assistance payment, in USD
utilityAllowanceAmountdoubleOptional
The utility allowance amount, in USD
marketRentAmountdoubleOptional
The market rent amount, in USD
grossRentAmountdoubleOptional
The gross rent amount, in USD
contractRentAmountdoubleOptional
The contract rent amount, in USD
maxRentAmountdoubleOptional
Maximum allowable rent captured at certification completion, in USD
maxIncomeAmountdoubleOptional
Maximum allowable household income captured at certification completion, in USD
ownerSignatureDatedateOptional
Date when the owner or agent signed the HUD 50059
customerSignatureDatedateOptional
Date when the head of household signed the HUD 50059
customerSignatureSuccessbooleanOptional
Indicates whether all required resident signatures were collected
eligibleHouseholdSizeintegerOptional
Eligible household size captured on the certification
numEligibleMembersintegerOptional
Number of people in the household
numDependentsintegerOptional
Number of household members classified as dependents for the certification, per HUD definition
uncountedHouseholdMembersintegerOptional
Number of adult members who reside in the unit but do not contribute financially and are not eligible for the subsidy
householdIncomeAmountdoubleOptional
Total annual income of the household, in USD
totalIncomeAmountdoubleOptional
Total annual household income on the certification, in USD
adjustedIncomeAmountdoubleOptional
Adjusted annual household income on the certification, in USD
householdAssetsAmountdoubleOptional
Total value of household assets, in USD
totalDeductionsAmountdoubleOptional
Total deductions amount, in USD
idstringOptionalformat: "uuid"
readableIdstringOptional
idempotencyIdstringOptionalformat: "uuid"
createdAtdatetimeOptional
updatedAtdatetimeOptional
deletedAtdatetimeOptional
householdIdstringOptionalformat: "uuid"
unitIdstringOptionalformat: "uuid"
floorPlanIdstringOptionalformat: "uuid"
propertyIdstringOptionalformat: "uuid"
organizationIdstringOptionalformat: "uuid"
housingPolicyIdstringOptionalformat: "uuid"
applicationIdstringOptionalformat: "uuid"

The ID of the application associated with this certification (for INITIAL certs)

housingPolicyobjectOptional
unitobjectOptional
floorPlanobjectOptional