Find tax-delinquent property leads in Dallas County or Collin County, Texas that match a buy box (score, tier, property use, lot size, appraised value, ZIP, owner location, years delinquent and more), using the same filter as the RBSHome map. Call with count_only=true first to size the list, then page through results (25 per page by default, up to 1,000 rows per filter). Each row has a lead_id for get_property and a url that opens it in RBSHome. Call list_filter_fields before using attrs. Returns no sale prices, valuations, phone numbers or emails. Rows count toward a daily row limit. Read-only.
View input schema
{
"type": "object",
"properties": {
"counties": {
"description": "Dallas, Collin or both. Omit for both.",
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"Dallas",
"Collin"
],
"description": "Dallas or Collin (Texas). No other county is covered."
}
},
"min_score": {
"description": "Lowest lead score, 0 to 100. Default 45. Ignored while tiers is set, as on the map.",
"type": "integer",
"minimum": 0,
"maximum": 100
},
"tiers": {
"description": "Lead tiers; A is the most distressed",
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"A",
"B",
"C",
"D"
]
}
},
"kinds": {
"description": "Property kinds from the tax roll",
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"vacant_lot",
"single_family",
"multifamily",
"commercial",
"mobile_home",
"builder_inventory",
"business_personal",
"minerals"
]
}
},
"property_use": {
"description": "Property use from the appraisal district",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"single_family",
"multifamily",
"vacant_lot",
"commercial",
"industrial",
"other"
]
}
},
"zips_include": {
"description": "Only these 5-digit ZIP codes",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{5}$"
}
},
"zips_exclude": {
"description": "Leave out these 5-digit ZIP codes",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{5}$"
}
},
"acres_min": {
"description": "Smallest lot, acres",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"acres_max": {
"description": "Largest lot, acres",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"market_value_min": {
"description": "Lowest appraisal-district market value, USD (not a price)",
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"market_value_max": {
"description": "Highest appraisal-district market value, USD (not a price)",
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"years_owned_min": {
"description": "Fewest years the owner has held it",
"type": "number",
"minimum": 0,
"maximum": 200
},
"years_owned_max": {
"description": "Most years the owner has held it",
"type": "number",
"minimum": 0,
"maximum": 200
},
"years_delinquent_min": {
"description": "Fewest delinquent tax years",
"type": "integer",
"minimum": 0,
"maximum": 100
},
"est_annual_tax_min": {
"description": "Lowest yearly tax levy, USD",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"est_annual_tax_max": {
"description": "Highest yearly tax levy, USD",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"portfolio_min": {
"description": "Owner holds at least this many Dallas and Collin properties",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"is_delinquent": {
"description": "Tax-delinquent: true = only these, false = leave these out, null = either",
"type": [
"boolean",
"null"
]
},
"out_of_state_owner": {
"description": "Owner mailing address outside Texas: true = only these, false = leave these out, null = either",
"type": [
"boolean",
"null"
]
},
"multiple_owners": {
"description": "More than one owner on title: true = only these, false = leave these out, null = either",
"type": [
"boolean",
"null"
]
},
"homestead": {
"description": "Property has a homestead exemption on the county tax roll: true = only these, false = leave these out, null = either",
"type": [
"boolean",
"null"
]
},
"include_keywords": {
"description": "Owner name contains any of these words",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[^,\\t\\n]+$"
}
},
"exclude_keywords": {
"description": "Owner name contains none of these words",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[^,\\t\\n]+$"
}
},
"jurisdiction_codes": {
"description": "Taxing jurisdiction codes",
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"near": {
"type": "object",
"properties": {
"lead_id": {
"type": "string",
"pattern": "^(Dallas|Collin):[A-Za-z0-9_-]{1,32}$",
"description": "RBSHome property id, County:account, for example 'Collin:2771234' or 'Dallas:00000776655'"
},
"radius_mi": {
"type": "number",
"minimum": 0.1,
"maximum": 1.5,
"description": "Radius in miles, 0.1 to 1.5"
}
},
"required": [
"lead_id",
"radius_mi"
],
"additionalProperties": false,
"description": "Only leads within radius_mi of this property's map pin"
},
"include_unmapped": {
"description": "Include leads with no map pin. Default false.",
"type": "boolean"
},
"include_institutional": {
"description": "Include school districts, banks and hospitals. Default false.",
"type": "boolean"
},
"attrs": {
"type": "object",
"propertyNames": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,39}$"
},
"additionalProperties": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"eq": {
"type": "boolean"
},
"in": {
"maxItems": 500,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"not_in": {
"maxItems": 500,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"keep": {
"type": "string",
"maxLength": 40
},
"unknown": {
"type": "string",
"enum": [
"include",
"exclude"
]
}
},
"additionalProperties": false
},
"description": "Attribute filters keyed by registry key, e.g. {\"flood_pct\":{\"max\":5}} or {\"flood_zone\":{\"not_in\":[\"AE\"]}}. Call list_filter_fields for the keys; never guess one."
},
"saved_filter_id": {
"description": "Start from this saved filter (ids from list_saved_filters); other fields change it",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"count_only": {
"default": false,
"description": "true returns only the count. Call this first to size the list.",
"type": "boolean"
},
"page": {
"default": 1,
"description": "Page, 1 to 40",
"type": "integer",
"minimum": 1,
"maximum": 40
},
"page_size": {
"default": 25,
"description": "Rows per page, 1 to 50. page x page_size may not pass 1,000.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"sort": {
"description": "score (default), levy (tax balance), years (years delinquent) or next_sale (next tax-sale date)",
"type": "string",
"enum": [
"score",
"levy",
"years",
"next_sale",
"motivation"
]
},
"sort_dir": {
"description": "Default desc; asc for next_sale (soonest first)",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}