{"contractVersion":"parcelops.connector.v1","name":"hud-multifamily","displayName":"HUD Multifamily Due Diligence","description":"Public assisted-property, subsidy-contract, inspection-score, and active FHA/HUD portfolio records.","tags":["hud","multifamily","affordable-housing","section-8","inspections","fha","residential"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"HUD Multifamily public data workbooks","sourceUrl":"https://www.hud.gov/hud-partners/multifamily-data","apiBaseUrl":"https://www.hud.gov/hud-partners/multifamily-data","documentationUrl":"https://www.hud.gov/hud-partners/multifamily-data"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."}},"coverage":{"geographic":{"status":"declared","value":["United States HUD multifamily portfolio represented in each workbook"]},"temporal":{"status":"not_declared"}},"methods":{"total":5,"items":[{"name":"searchAssistedProperties","description":"Search the public assisted-property workbook with a bounded property or location selector.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"city":{"type":"string","minLength":1,"maxLength":100},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"propertyId":{"type":"string","minLength":1,"maxLength":50},"propertyName":{"type":"string","minLength":2,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]},{"name":"searchExpiringContracts","description":"Search contracts by property, exact contract number, or expiration window.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"city":{"type":"string","minLength":1,"maxLength":100},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"propertyId":{"type":"string","minLength":1,"maxLength":50},"propertyName":{"type":"string","minLength":2,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100},"contractNumber":{"type":"string","minLength":1,"maxLength":50},"expirationFrom":{"type":"string","format":"date"},"expirationTo":{"type":"string","format":"date"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]},{"name":"searchInspectionScores","description":"Search current published HUD multifamily physical-inspection scores.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"city":{"type":"string","minLength":1,"maxLength":100},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"propertyId":{"type":"string","minLength":1,"maxLength":50},"propertyName":{"type":"string","minLength":2,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100},"scoreAtMost":{"type":"number","minimum":0,"maximum":100},"inspectedFrom":{"type":"string","format":"date"},"inspectedTo":{"type":"string","format":"date"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]},{"name":"searchPortfolioProperties","description":"Search active HUD/FHA multifamily portfolio property attributes.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"city":{"type":"string","minLength":1,"maxLength":100},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"propertyId":{"type":"string","minLength":1,"maxLength":50},"propertyName":{"type":"string","minLength":2,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":100},"category":{"type":"string","minLength":1,"maxLength":100},"insuredOnly":{"type":"boolean"},"subsidizedOnly":{"type":"boolean"},"hudOwnedOnly":{"type":"boolean"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]},{"name":"getServiceInfo","description":"Return workbooks, refresh semantics, fields, privacy policy, and limitations.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Assistance, contract, active-portfolio, and current inspection workbooks follow HUD publication schedules."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]}]},"caveats":["Records are public screening context, not proof of current ownership, financing, physical condition, rent restriction, or contract renewal.","ParcelOps excludes tenant data, personal contacts, phone numbers, and email addresses.","The current inspection alias is verified against HUD’s July 1, 2026 publication and should be re-smoked when HUD changes its export."]}