Skip to main content
GET
List the investors active inside an area
The same location and filters as GET /v1/deals, with one row per Investor instead of one per deal. The location is a radius, a viewport, a parcel, or a ZIP list or postal city.

​
Use it when

The investor table beside the map.

​
Read the response

  • investor is the investor across the whole market. in_radius is what they did inside this geometry after your filters. in_radius.n_purchase_events counts distinct purchase days here, so a bulk buy of twelve parcels on one day is one event. investor_deals_min and the default sort use that count.
  • in_radius.last_bought_on counts purchases only. in_radius.last_deal_on also counts sales and transfers here, and is for display.
  • The API measures nearest_distance_miles from lat + lng or from the property_id parcel. It is null with a bare bbox, zip or city. lat + lng beside any of them is the reference point and nothing more.
  • meta.geometry echoes the location that ran. The envelope describes it.
  • contact carries the top three non-generic mailing addresses, the top five person members and the top three skip-trace targets. The profile carries all of them.
  • investor.member_names lists the entity and trust names. This host does not serve the person names behind an entity, so the list leaves them out.
  • investor.operator_id and n_operator_members group several ids into one buyer. See the Investor object for the collapse rule. The profile carries the operator’s capital cycle and activity probability as buyer_signal.
  • Two filters read the lender registry (since 0.16.0). financed_by=len_... keeps the investors with any loan the registry ties to them from that lender. uses_private_lender=true keeps those with a loan in the registry’s 24-month window from a hard-money, investor, INDIVIDUAL or PRIVATE lender. Both read the registry’s borrower match, which sees about one loan in five. So they narrow to a floor and never test for cash. In a market without a published registry or borrower match, the API answers 422 lenders_unavailable.
  • holds_min and holds_max (since 0.26.0) keep the investors whose market-wide portfolio, investor.n_holds, is inside the band. holds_min=20 keeps the larger portfolios. holds_max=0 keeps the investors that hold nothing. The two together make a band. sort=holds_desc orders the rows by in_radius.n_holds, the holdings inside this geometry, like every other sort here. Holdings has the profile’s statistic over the market-wide count.
  • summary describes the whole geometry, not the page. n_investors_ranked is how many rows the pages walk.

​
Gotchas

  • The list hides institutional investors unless scale includes institutional, and public bodies unless include_public=true. Buyers without an investor id never appear here at all: see summary.by_buyer_status, and /v1/deals?buyer_status=unclassified for the deals behind them.
  • This host does not serve the contact block (null, contact_redacted: true), and it does not serve the person names in member_names.
  • The cursor becomes invalid on any change of query and on a data refresh.
  • This route has no CSV on api.investorlift.com. Page the JSON list instead: Give me a spreadsheet. The one public CSV is the loans of a lender.
  • A radius over five miles, a city, or a list of more than six ZIPs waits in a queue behind other large queries. On Free and Starter the place is one ZIP (Plans and limits).
  • The API follows investor_id= with an old id to the current investor and echoes the old id in meta.resolved_from. A retired id is 410 gone.
Top buyers in a place runs this list over one ZIP with a trailing bought_after window. It reads in_radius.n_purchase_events beside the market-wide facts. Same buyer, cash right now covers operators.

Authorizations

​
Authorization
string
header
required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.

Query Parameters

​
kind
enum<string>[]

Deal kinds to keep (comma list or repeated key). Default: every kind.

Minimum array length: 1

What occurred on the deal. flip: bought, fixed and resold within about a year at a profit-shaped margin; wholesale: bought and resold in under 30 days, or a chain resale or round trip within 90 (a double close); hold: bought and still owned at data_end, a confirmed holding or an un-resold purchase; long_hold: held over a year, then sold (a landlord exit); other: an investor resale that is not a clean flip. Reasons: a loss, a thin margin, a builder's new home resold, an iBuyer resale, or a chain resale of 3 to 12 months; build: a registered investor bought a lot or teardown, built a house on it during the hold, then sold. A builder's finished home bought and resold is other. On data built after 2026-09-17 the kind keeps only a single-family parcel held over 90 days, its house complete by the sale year. A market built on or before 2026-09-17 (meta.coverage[].loaded_at) counts every lot-to-build resale by a registered investor as a build until its next build.

Available options:
flip,
wholesale,
hold,
long_hold,
other,
build
​
price_min
integer

Minimum bought price, inclusive, integer dollars. When you set price_min or price_max, the API drops null-priced rows unless include_unpriced=true.

Required range: 0 <= x <= 9007199254740991
​
price_max
integer

Maximum bought price, inclusive, integer dollars.

Required range: 0 <= x <= 9007199254740991
​
bought_after
string

Keep deals bought on or after this date. When you set bought_after or bought_before, the API drops null-date rows unless include_undated=true.

​
bought_before
string

Keep deals bought on or before this date.

​
sold_after
string

Resold deals only: sold on or after this date.

​
sold_before
string

Resold deals only: sold on or before this date.

​
segment
enum<string>[]

Parcel segments to keep. Default: every segment.

Minimum array length: 1

Parcel segment: SFR, CONDO_TH (condo or townhouse) or OTHER, a mixed bucket of manufactured, multi-family, land and commercial parcels.

Available options:
SFR,
CONDO_TH,
OTHER
​
beds_min
integer

Minimum bedrooms, inclusive.

Required range: 0 <= x <= 50
​
sqft_min
integer

Minimum living area in square feet, inclusive, 0 to 1,000,000.

Required range: 0 <= x <= 1000000
​
sqft_max
integer

Maximum living area in square feet, inclusive, 0 to 1,000,000.

Required range: 0 <= x <= 1000000
​
investor_kind
enum<string>[]

Keep investors that carry at least one listed kind. The check reads any of their kinds[], never the primary kind. Default: every kind. Buyers without an investor id pass unless registered_only=true.

Minimum array length: 1

Investor kind, the primary one of kinds[] (an investor can carry several), for display only. FLIPPER: buys, renovates and resells. WHOLESALER: buys to resell quickly, often through a double close. LANDLORD: buys and holds rentals. BUILDER: builds on lots it buys. IBUYER: Opendoor, Offerpad or Zillow.

Available options:
FLIPPER,
WHOLESALER,
LANDLORD,
BUILDER,
IBUYER
​
investor_kind_exclude
enum<string>[]

Drop investors that carry any listed kind. The API checks kinds[] after investor_kind. investor_kind_exclude=WHOLESALER removes investors who also wholesale.

Minimum array length: 1

Investor kind, the primary one of kinds[] (an investor can carry several), for display only. FLIPPER: buys, renovates and resells. WHOLESALER: buys to resell quickly, often through a double close. LANDLORD: buys and holds rentals. BUILDER: builds on lots it buys. IBUYER: Opendoor, Offerpad or Zillow.

Available options:
FLIPPER,
WHOLESALER,
LANDLORD,
BUILDER,
IBUYER
​
investor_confidence_min
enum<string>

Minimum registry confidence in the investor kind: STRONG, PROBABLE or WEAK (WEAK admits everything).

Available options:
STRONG,
PROBABLE,
WEAK
​
scale
enum<string>[]

Scale tiers to keep. Default: every tier except institutional. An explicit list replaces the default entirely. scale=institutional alone returns only institutional. scale=individual,small,mid,large,institutional returns everyone.

Minimum array length: 1

Investor scale: individual (one person, no entity), small (fewer than 10 investment deals), mid (10 to 99), large (100 to 999) or institutional. An institutional investor is an iBuyer, a production builder, a bulk landlord with 500 or more holdings, or a known brand from a list. The registry counts the deals inside the area loaded for the market (meta.coverage[].universe_kind), so in a ZIP market the tier is a floor.

Available options:
individual,
small,
mid,
large,
institutional
​
include_public
enum<string>

Include public-body investors (counties, cities, housing authorities) and their deals. Default false: every list endpoint hides them.

Available options:
true,
false
​
include_unpriced
enum<string>

Keep null-priced rows when you set price_min or price_max (default false).

Available options:
true,
false
​
include_undated
enum<string>

Keep null-date rows when you set bought_after or bought_before (default false).

Available options:
true,
false
​
active_within_months
integer

Keep investors whose last purchase is at most this many months before data_end (data_end minus last_bought_on). Sales and transfers do not count. No default.

Required range: 1 <= x <= 600
​
investor_deals_min
integer

Minimum purchase events of that investor inside the geometry, 1 to 1,000,000. The API applies it after the other filters.

Required range: 1 <= x <= 1000000
​
holds_min
integer

Investor filter: keep investors who hold at least this many parcels across the whole market at the deed data end (meta.coverage[].data_end). The count is the investor's n_holds: confirmed holdings plus un-resold purchases inside the area loaded for the market, not the holdings inside the geometry. Range 0 to 1,000,000, inclusive. For example, holds_min=20 keeps the larger portfolios. Buyers without an investor id pass unless registered_only=true.

Required range: 0 <= x <= 1000000
​
holds_max
integer

Investor filter: keep investors who hold at most this many parcels across the whole market at the deed data end (n_holds). Range 0 to 1,000,000, inclusive. holds_max=0 keeps the investors that hold nothing. Beside holds_min the pair is a band. Buyers without an investor id pass unless registered_only=true.

Required range: 0 <= x <= 1000000
​
buys_wholesale
enum<string>

Investor filter: at least one bought-from-wholesaler deal in the 36 months before data_end.

Available options:
true,
false
​
buys_at_auction
enum<string>

Investor filter: true keeps investors who bought at least one house at a foreclosure auction in the 24 months before data_end. A foreclosure auction is a trustee's sale or an Arizona sheriff's sale, and the filter reads investor.auction.is_active_auction_buyer. These buyers pay cash within a day and buy without an inspection. False keeps registered investors who did not. Buyers without an investor id pass unless registered_only=true. The API answers 422 auction_unavailable in a market that does not publish its auction counts (meta.coverage[].auction_counted false).

Available options:
true,
false
​
buys_reo
enum<string>

Investor filter: true keeps investors who bought at least one house from a lender, servicer or agency after a foreclosure. The window is the 24 months before data_end, and the filter reads investor.auction.is_active_reo_buyer. A bank-owned (REO) sale gave the buyer weeks, an inspection and the option to finance: the weaker cash signal beside buys_at_auction. False keeps registered investors who did not, and buys_at_auction=true&buys_reo=false is the cash-only set. Buyers without an investor id pass unless registered_only=true. The API answers 422 auction_unavailable where the market does not publish its auction counts.

Available options:
true,
false
​
bought_auction_kind
enum<string>[]

Deal filter: keep deals whose purchase deed was a third-party auction purchase of one of the listed kinds (comma list or repeated key). For example, bought_auction_kind=TRUSTEE_SALE keeps houses bought at a foreclosure sale. The API drops deals bought any other way and deals without a buy deed. The API answers 422 auction_unavailable where the market does not publish its auction counts.

Minimum array length: 1

The kind of auction the purchase deed records: TRUSTEE_SALE and SHERIFF_SALE count toward buys_at_auction, and the API shows the other three but never counts them. TRUSTEE_SALE: a lender's foreclosure sale by the trustee, cash and final on the day, without redemption. In Arizona the buyer pays a $10,000 deposit and the full bid by 5 pm the next business day. In Texas it is the first-Tuesday courthouse sale, in Washington the Friday sale at the county's designated place under RCW 61.24. SHERIFF_SALE: a judicial sale under court order. In Arizona it is an HOA or judgment-lien sale, cash but subject to the first mortgage and to a 30-day or 6-month redemption. In Washington it is a judicial mortgage foreclosure or lien sale under RCW 6.21, with an 8-month or 1-year redemption. In Washington the sale is subject to the senior lien only when it is a lien sale. HOA_TRUSTEE_SALE: a Texas homeowners association foreclosure recorded as a trustee's deed, cash, subject to the first lien and to a 180-day redemption. TAX_SALE: a Texas constable or taxing-unit tax sale, cash, with a 180-day or 2-year redemption. In Washington it is the county treasurer's deed after the tax foreclosure judgment, with no redemption after the sale. TAX_LIEN_DEED: an Arizona treasurer's deed to a tax-lien holder, mostly vacant land, not an auction of the house.

Available options:
TRUSTEE_SALE,
SHERIFF_SALE,
HOA_TRUSTEE_SALE,
TAX_SALE,
TAX_LIEN_DEED
​
bought_from_wholesaler
enum<string>

Deal filter: bought through a documented double close from a wholesaler, or from a known wholesaler. Assignments leave no deed, so absence is not evidence.

Available options:
true,
false
​
bought_distressed
enum<string>

Deal filter: the buy leg was a distressed sale. That is a foreclosure, trustee, sheriff or tax instrument, a deed in lieu, or a deed the feed flags as REO. It is wider than bought_auction_kind, which keeps only third-party auction purchases.

Available options:
true,
false
​
registered_only
enum<string>

Keep only rows whose buyer carries an investor id (investor.id is not null).

Available options:
true,
false
​
buyer_status
enum<string>[]

Buyer statuses to keep.

Minimum array length: 1

The buyer's standing in the registry: registered (has an investor id), unclassified, excluded or unknown (the deed names no buyer). Unclassified: a named buyer the registry did not classify as an investor, usually a household. Excluded: a named buyer the registry deliberately left out. Those are custodian trusts, relocation companies, auction houses and ambiguous surnames.

Available options:
registered,
unclassified,
excluded,
unknown
​
str_operator
enum<string>

Investor filter: true keeps investors that hold at least one parcel with a business-use short-term-rental licence attributed to them. That is the str roll-up's n_holdings at 1 or more. False keeps investors with none. Buyers without an investor id pass unless registered_only=true. The API answers 422 str_unavailable when a market in play has no short-term rental tables (meta.coverage[].str_as_of null).

Available options:
true,
false
​
str_holdings_min
integer

Investor filter: at least this many of the investor's holdings carry a business-use short-term-rental licence attributed to them (the str roll-up's n_holdings), 1 or more. Buyers without an investor id pass unless registered_only=true. The API answers 422 str_unavailable when a market in play has no short-term rental tables.

Required range: 1 <= x <= 100000
​
financed_by
string

Investor filter: keep investors with at least one recorded loan from this lender, as the main borrower of the mortgage or the open lien. The value is a lender id, len_ followed by 12 hex characters, for example len_d2028f0766fc from GET /v1/lenders/search. The match is investor_id on the lender's loan rows. The count is a floor: the recorded history sees about one loan in five. Buyers without an investor id pass unless registered_only=true. The API answers 422 lenders_unavailable when a market in play has no lender registry with the borrower match (meta.coverage[].lenders null or borrowers_measured false).

Pattern: ^len_[0-9a-f]{12}$
​
uses_private_lender
enum<string>

Investor filter: true keeps investors with a loan from a private lender, recorded in the 24 months before the lender registry's slice date (meta.coverage[].lenders.as_of). A private lender is a hard-money lender by name or behaviour (is_hard_money) or an investor lender by behaviour (is_investor_lender). A lender whose class reads INDIVIDUAL or PRIVATE also counts as private. False keeps registered investors with none such, and the result is a floor of a partial feed. Buyers without an investor id pass unless registered_only=true. The API answers 422 lenders_unavailable when a market in play has no lender registry with the borrower match.

Available options:
true,
false
​
investor_id
string

Scope the rows to one buyer (the drawer's "Activity here"). The API follows an old id from an earlier data refresh to the investor that superseded it and echoes the old id in meta.resolved_from. A retired id is 410 gone.

Pattern: ^inv_[0-9a-f]{12}$
​
deal_id
string

Scope the rows to one deal.

Pattern: ^deal_[0-9a-f]{32}$
​
lat
number

Point latitude (with lng). With radius_miles it is the search geometry. With bbox it is the reference point only.

Required range: -90 <= x <= 90
​
lng
number

Point longitude (with lat).

Required range: -180 <= x <= 180
​
radius_miles
number

Search radius in miles around the point or around the centre of the property_id parcel, 0.25 to 20 (default 2). Not allowed with bbox.

Required range: 0.25 <= x <= 20
​
bbox
string

Viewport as west,south,east,north (WGS84 degrees). West must be less than east, south less than north, and the diagonal at most 40 mi. It must intersect a loaded market's coverage bbox (422 outside_coverage otherwise). It can carry lat + lng (without radius_miles) as the reference point for distances and sort=distance.

​
property_id
string

Parcel geometry: search around the centre of that parcel, with radius_miles. Not allowed with lat, lng or bbox.

Pattern: ^prop_[0-9a-f]{32}$
​
zip
string[]

Place geometry: the parcels of these 5-digit ZIP codes, as a comma list or a repeated key, up to 50. On the deal and investor routes the Free and Starter plans take exactly one ZIP, and more is 403 plan_limit. You can add lat + lng as the reference point for distances. Not with radius_miles, bbox, property_id or city. A ZIP that no parcel of a loaded market carries is 422 outside_coverage (zips_unknown in the body).

Required array length: 1 - 50 elements
Pattern: ^\d{5}$
​
city
string

Place geometry: the parcels whose postal city is this one, as the county records it ("Scottsdale"). Case does not matter: the API compares the value folded upper case. Never the short-term rental jurisdiction (meta.coverage[].str.jurisdictions[]). You can add lat + lng as the reference point, but not radius_miles, bbox, property_id or zip. On the deal and investor routes of the Free and Starter plans a city-wide search is 403 plan_limit. A city that no parcel of a loaded market carries is 422 outside_coverage.

Required string length: 1 - 100
​
sort
enum<string>

Row order over what the investor did inside the geometry. The default is events_desc (most purchase days first). Or parcels_desc (most parcels) or volume_desc (largest purchase total). Or last_bought_desc (newest purchase) or last_deal_desc (newest purchase, sale or transfer). Or flips_desc (most flips) or holds_desc (most current holdings inside the geometry at data_end). The holdings count is in_radius.n_holds, and the market-wide portfolio is the holds_min / holds_max filter.

Available options:
events_desc,
parcels_desc,
volume_desc,
last_bought_desc,
last_deal_desc,
flips_desc,
holds_desc
​
limit
integer
default:100

Page size, 1-200 (default 100).

Required range: 1 <= x <= 200
​
cursor
string

Opaque cursor from page.next_cursor of the previous page. A change of query, sort, weights or data version invalidates it (400 invalid_cursor). Then restart from page 1.

Required string length: 1 - 4096

Response

Investors active inside the geometry, one page, best first by the requested sort, with the totals over the whole geometry.

Investors active inside the geometry, one page, best first by the requested sort, with the totals over the whole geometry.

​
data
object[]
required

The rows of this page.

​
page
object
required

Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.

​
meta
object
required

Response metadata: when the API produced it, which markets it covers, and how fresh they are.

​
summary
object
required

Totals over the geometry after the shared filters, the same on every page.