> ## Documentation Index > Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt > Use this file to discover all available pages before exploring further. # Rank buyers for a property > The nearby investors that best fit this house, ranked, with the reasons behind each score. The location is a point with `radius_miles`, a `bbox` or a `property_id`. This route takes no `zip` or `city`, because the match ranks near a point. The deal's price, ARV, condition and segment are optional. The API returns the investors who bought in the area, ranked by how well they fit. Each row carries the reasons behind its score, proof deals and a contact block. ## Use it when You have a subject property. This is the first call of the God Mode screen and the drawer's "similar buyers" refresh. | Instead use | When | | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | | [`GET /v1/investors`](/api-reference/endpoints/investors-list) | You have no subject: the same investors sorted by activity, not by fit. | | [`GET /v1/deals`](/api-reference/endpoints/deals-list) | You want the deals themselves, for a table or a map. | | [`GET /v1/investors/{id}`](/api-reference/endpoints/investors-get) | You already know which buyer you mean. | ## How the score is built `score` runs 0 to 1, best first, and is `base_score × activity_multiplier`. `base_score` is `gate` times the weighted mean of the factor values in `reasons[]`. Those weights sum to 1. With the default `w_activity=0`, the multiplier is 1 and `score` equals `base_score`. The API rounds `score`, `base_score`, `activity_multiplier`, `reasons[].weight`, `reasons[].value` and `meta.weights` to four decimals. So the identity holds to about 0.0005. The ranking itself uses the unrounded score. **Compare scores only within one response.** A different subject, radius, weight set or `w_activity` is a different scale. ### The factors | Factor | What it measures | | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `proximity` | How many separate purchase **days** they had inside the area, and how close. A bulk buy of 20 condos on one day counts once. | | `recency` | How recently and how often they buy, measured at the data's end date. A sale never counts: a flipper who just sold is still an active buyer. | | `price_fit` | If the subject price sits inside the band of what they pay. The subject price is the asking price, else ARV times their usual buy-to-resale ratio. A price cheaper than usual gets a smaller penalty than a dearer one. | | `strategy` | If their kinds (flipper, landlord, builder, wholesaler, iBuyer) suit the subject condition. | | `segment` | The share of their deals in the subject segment. | | `wholesale_buyer` | Documented purchases from wholesalers in the last five years. A lower bound: a contract assignment leaves no deed. | | `resale_fit` | The ARV against the median resale price of their flips. Weight 0 by default, so the UI can show it without moving the score. | | `financing` | If the investor borrowed from a lender that also lends in the subject's ZIP, in the lender registry's 24-month window. `detail` names the lender. Weight 0 by default. The factor is absent where the market has no published registry or borrower match. A floor: the match sees about one loan in five. | A factor is **absent** from `reasons[]` when nothing feeds it: * no asking price or ARV (`price_fit`) * no condition (`strategy`) * no segment (`segment`) * no reference point (`proximity`) * no priced purchases on record (`price_fit`) The API shares its weight out over the others. It rescales the `w_*` weights of the factors it can score, so they sum to 1. `meta.weights` shows that effective set for the request. `reasons[].weight` shows the row's own set. There the API halves `price_fit` for an investor with fewer than three priced purchases. `gate` is 0.5 for an investor whose last purchase is more than three years before the data end, or who never bought at all. So a dormant investor ranks lower but stays in the list. ### The activity weight `w_activity` (0 to 1, default 0) is a power. The API raises `buyer_signal.activity_p_180`, the operator's probability of a purchase in the 180 days after the data end, to that power. The API then multiplies each score by the result. `w_activity=1` ranks by expected purchases. `0.5` softens it. The API scores an investor without a probability at the measured dormant re-activation rate. The `w_activity` parameter documents that rate. Such an investor is a dormant operator, or one with no signal row. The response shows the multiplier as `activity_multiplier`. It is not a factor, so `reasons[]` and `meta.weights` do not change. ### The buyer signal `buyer_signal` is the **operator** behind the investor. `operator_id` and `operator_member_ids` tie together the LLCs, trusts and people linked by shared mailing addresses and shared names. `cycle_state` and `capital_freed_60d` say where that operator is in its capital cycle. `activity_p_180` is its fitted probability of another purchase. Its "days since" values are the operator's, measured from the data end date. The block is null where no signal exists for the market. Rows that share an `investor.operator_id` are one buyer: collapse them and contact them once. The API ranks and pages each id on its own. So an operator with three ids can appear three times, and across pages. Keep the row whose id equals `operator_id` as the visible one. `score` and `in_radius` are per id, and the API never sums them per operator. [Same buyer, cash right now](/guides/walkthroughs/same-buyer) works through it. ## Read the rest of a row * `in_radius` is what they did inside the area after your filters. `investor` is their whole-market profile. It is normal for the two to disagree. See [the Investor object](/api-reference/objects/investor). * `sample_deals` are up to five of their deals here, nearest first: proof to show the user. * `summary` counts the whole area, not the page. `n_investors_ranked` is how many rows the pages walk. * The API follows `investor_id=` with an old id to the current investor and echoes the old id in `meta.resolved_from`. For a retired id, the API answers `410 gone`. * `meta.geometry` echoes the area that ran. [The envelope](/api-reference/objects/envelope) describes it. ## Gotchas * **By default the list hides institutional buyers and public bodies.** They top every neighbourhood by volume and are almost never the buyer for a wholesale deal. To see them, pass `scale=individual,small,mid,large,institutional` and `include_public=true`. * **Filters narrow the deals that count. The subject facts and weights only change the score.** `investor_deals_min` counts purchase days inside the area. * `financed_by=len_...` and `uses_private_lender=true` (since 0.16.0) read the lender registry. The first keeps the investors the registry ties to that lender. The second keeps the investors it ties to a hard-money, investor, `INDIVIDUAL` or `PRIVATE` lender in its window. Both answer [`422 lenders_unavailable`](/guides/concepts/errors#lenders_unavailable) where the market has no published registry or borrower match. `w_financing` weights the `financing` reason. * `holds_min` and `holds_max` (since 0.26.0) keep the investors whose market-wide `investor.n_holds` sits inside the band. For example, `holds_min=20` keeps the larger portfolios. They narrow the ranking and never move a score. * The API never infers `subject_asking_price` or `subject_arv`. `subject_segment`, `subject_beds` and `subject_sqft` default from the parcel when the geometry is `property_id`. The API accepts `subject_beds` and `subject_sqft` but does not score them yet. * With `bbox` and no `lat` + `lng`, the request has no reference point. The API drops `proximity`, distances are null and samples come back most recent first. * `include_unregistered=true` adds `summary.unregistered[]`: the households and unclassified names that bought here, at most 200. The API scores them on proximity and recency only. They are leads, not investors, and have no id. Their `score` is on the `base_score` scale. So with `w_activity` above 0 it is not comparable to `data[].score`. This host does not serve their `name`: it is null, with `contact_redacted: true`. * This host does not serve contact fields. They are null, with `contact_redacted: true`, and `investor.member_names` lists entity and trust names only. * Any change of filters, subject facts, weights or `w_activity` invalidates the cursor ([`400 invalid_cursor`](/guides/concepts/errors#invalid_cursor)). * This route has no CSV on `api.investorlift.com`. Page the JSON list ([Give me a spreadsheet](/guides/walkthroughs/spreadsheet)). The one public CSV is [the loans of a lender](/api-reference/endpoints/lenders-loans#csv). * Likely errors: [`geometry_required`](/guides/concepts/errors#geometry_required), [`geometry_conflict`](/guides/concepts/errors#geometry_conflict), [`outside_coverage`](/guides/concepts/errors#outside_coverage), and [`statement_timeout`](/guides/concepts/errors#statement_timeout) on a 20 mile radius with heavy filters. `geometry_conflict` is also the answer to a `zip` or `city`. The deals and investor lists take those, and this route does not. ## Related [Buyers for a house under contract](/guides/walkthroughs/find-buyers) walks through a full response. [Same buyer, cash right now](/guides/walkthroughs/same-buyer) covers operators and `w_activity`. ## OpenAPI ````yaml GET /v1/buyers/match openapi: 3.1.0 info: title: God Mode API version: 0.33.1 description: >- You have a house to sell, usually a wholesale contract. You want to know **who nearby buys houses like this one and how to reach them**. County deed records already hold the answer. This API reads them for each loaded market and serves three things: deals, investors and a ranking. On every response, `meta.coverage[]` lists the markets and the area each covers. **Deals** are every investment purchase, flip, wholesale and current investor holding. **Investors** are the buyers behind them, grouped so that the LLCs of an operator and the person behind them count as one. **A ranking** says, for a given house, which investors are the best fit and why. The documentation site at https://developers.investorlift.com carries the guides, the walkthroughs, the error catalogue and the connection steps for MCP clients. https://developers.investorlift.com/llms.txt indexes the site for a model. This document is the machine-readable reference behind the API tab of the site. **Start here.** Ranked buyers for a house at 7522 E Cholla St, Scottsdale, under contract at $410,000 and in need of a major rehab: ``` GET https://api.investorlift.com/v1/buyers/match?lat=33.476917&lng=-111.920385&radius_miles=2&subject_asking_price=410000&subject_condition=MAJOR_REHAB Authorization: Bearer zpka_... ``` **Conventions.** Responses are `{ data, meta }`. Lists add `page` (an opaque cursor) and sometimes `summary`. A list parameter takes commas or repeated keys. Dates are YYYY-MM-DD. Ids carry a prefix: `deal_`, `prop_`, `inv_`, `agt_`, `wl_`, `wsr_`. Money is whole dollars. It is null, never 0, when the deed carries no price. Coordinates are WGS84. A location is a point and radius (`lat`, `lng`, `radius_miles`), a viewport (`bbox=west,south,east,north`) or a parcel (`property_id`). This host does not serve the people behind an entity, mailing addresses, owner identity, mortgage borrowers or lien parties. It does not serve the names, phones, emails and licence numbers of listing agents. It serves the entities, the deals, the listings and the ranking. Errors are RFC 9457 problem+json with a `code` to switch on. The catalogue is https://developers.investorlift.com/problems.json and the Errors page of the site. The field `meta.coverage[].dataset_version` changes only when a refresh rebuilds the tables of a market. Use it in cache keys, or poll `GET /v1/dataset`. **MCP.** The API serves the same data to Model Context Protocol clients at `POST https://api.investorlift.com/mcp` with the same key: twenty-six read-only tools, four resources, seven prompts. The MCP tab of the documentation site has the client setup. The file `mcp-manifest.json` beside this document lists the tools with their input schemas. Problem codes: 400 validation_error, 400 unknown_parameter, 400 invalid_cursor, 400 geometry_required, 400 geometry_conflict, 400 sort_requires_point, 400 invalid_id, 400 market_required, 401 unauthorized, 403 quota_exceeded, 403 subscription_required, 403 payment_overdue, 403 plan_limit, 404 not_found, 406 not_acceptable, 410 gone, 422 outside_coverage, 422 ambiguous_apn, 422 ambiguous_address, 422 csv_cap_exceeded, 422 listings_unavailable, 422 agents_unavailable, 422 lenders_unavailable, 422 wholesale_unavailable, 422 str_unavailable, 422 cash_sale_unavailable, 422 auction_unavailable, 422 parcels_unavailable, 422 addresses_unavailable, 422 dated_refused, 422 history_unavailable, 400 quicklist_unavailable, 400 dataset_unavailable, 429 rate_limited, 500 internal_error, 503 database_unavailable, 503 pool_saturated, 503 ledger_unavailable, 504 statement_timeout. servers: - url: https://api.investorlift.com security: - bearerAuth: [] tags: - name: buyers x-group: Buyers description: >- Which investors are the best fit for this house: the API ranks nearby investors against a subject property and explains each score. - name: deals x-group: Deals description: >- What occurred around a location: deals for a table, cells for a map, summary stats, and one deal by id. - name: investors x-group: Investors description: >- Who the buyers are: investors active in an area, a full profile, and their metro-wide history. A search finds an investor by any name they buy under. - name: properties x-group: Properties description: >- One parcel: find it from a point or an APN, then read its facts, owner information, short-term rental licence and every deal on it. The owner information covers investor holdings and business-use short-term rentals. - name: agents x-group: Listing agents description: >- Who the listing agents are: find one by name or licence number, then read the profile and every listing of theirs. The profile holds the licence, the brokerages, the listing counts and the investors they belong to. - name: wholesale x-group: Investorlift listings description: >- Investorlift listings as wholesale transactions: the houses listed, and what the county deeds show for each (closed, to whom, which deed). Also the listing companies, and what each investor bought off Investorlift. - name: lenders x-group: Lenders description: >- Who lends on houses in a market: find a lender by any spelling of its name. Rank the lenders of a market, or of one ZIP, city or county. Read a profile: loans counted once across the open-lien and recorded-history tables, the open book, terms, geography and rankings. List every loan of one lender. - name: dataset x-group: Dataset and coverage description: >- What the API serves, how fresh it is and which data is available where. The dataset version and the last deed date of every market, for cache keys and freshness checks. The coverage matrix, with a place lookup. - name: contract x-group: By contract description: >- Routes sold per jurisdiction under an order form and not reachable on a self-serve key. Ask through the console. externalDocs: description: >- The documentation site: the guides, the walkthroughs, the error catalogue and the MCP connection steps. url: https://developers.investorlift.com paths: /v1/buyers/match: get: tags: - buyers summary: Rank nearby investors as buyers for a property description: >- The investors who bought near a subject property, ranked by how well they fit it. Each carries the reasons behind its score and proof deals. Give a point, a viewport or a parcel, not a ZIP or city: it ranks near a point. You can add the deal's price, ARV, condition and segment. Use `/v1/investors` for the same investors without a subject, sorted by activity instead of fit, and `/v1/investors/{id}` when you already know the buyer. [How the score is built, the factors, and the activity weight](https://developers.investorlift.com/api-reference/endpoints/buyers-match). operationId: matchBuyers parameters: - schema: minItems: 1 type: array items: type: string enum: - flip - wholesale - hold - long_hold - other - build description: >- 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. in: query name: kind required: false description: >- Deal kinds to keep (comma list or repeated key). Default: every kind. - schema: type: integer minimum: 0 maximum: 9007199254740991 in: query name: price_min required: false description: >- Minimum bought price, inclusive, integer dollars. When you set price_min or price_max, the API drops null-priced rows unless include_unpriced=true. - schema: type: integer minimum: 0 maximum: 9007199254740991 in: query name: price_max required: false description: Maximum bought price, inclusive, integer dollars. - schema: type: string in: query name: bought_after required: false description: >- 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. - schema: type: string in: query name: bought_before required: false description: Keep deals bought on or before this date. - schema: type: string in: query name: sold_after required: false description: 'Resold deals only: sold on or after this date.' - schema: type: string in: query name: sold_before required: false description: 'Resold deals only: sold on or before this date.' - schema: minItems: 1 type: array items: type: string enum: - SFR - CONDO_TH - OTHER description: >- Parcel segment: SFR, CONDO_TH (condo or townhouse) or OTHER, a mixed bucket of manufactured, multi-family, land and commercial parcels. in: query name: segment required: false description: 'Parcel segments to keep. Default: every segment.' - schema: type: integer minimum: 0 maximum: 50 in: query name: beds_min required: false description: Minimum bedrooms, inclusive. - schema: type: integer minimum: 0 maximum: 1000000 in: query name: sqft_min required: false description: Minimum living area in square feet, inclusive, 0 to 1,000,000. - schema: type: integer minimum: 0 maximum: 1000000 in: query name: sqft_max required: false description: Maximum living area in square feet, inclusive, 0 to 1,000,000. - schema: minItems: 1 type: array items: type: string enum: - FLIPPER - WHOLESALER - LANDLORD - BUILDER - IBUYER description: >- 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. in: query name: investor_kind required: false description: >- 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. - schema: minItems: 1 type: array items: type: string enum: - FLIPPER - WHOLESALER - LANDLORD - BUILDER - IBUYER description: >- 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. in: query name: investor_kind_exclude required: false description: >- Drop investors that carry any listed kind. The API checks kinds[] after investor_kind. investor_kind_exclude=WHOLESALER removes investors who also wholesale. - schema: type: string enum: - STRONG - PROBABLE - WEAK in: query name: investor_confidence_min required: false description: >- Minimum registry confidence in the investor kind: STRONG, PROBABLE or WEAK (WEAK admits everything). - schema: minItems: 1 type: array items: type: string enum: - individual - small - mid - large - institutional description: >- 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. in: query name: scale required: false description: >- 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. - schema: type: string enum: - 'true' - 'false' in: query name: include_public required: false description: >- Include public-body investors (counties, cities, housing authorities) and their deals. Default false: every list endpoint hides them. - schema: type: string enum: - 'true' - 'false' in: query name: include_unpriced required: false description: >- Keep null-priced rows when you set price_min or price_max (default false). - schema: type: string enum: - 'true' - 'false' in: query name: include_undated required: false description: >- Keep null-date rows when you set bought_after or bought_before (default false). - schema: type: integer minimum: 1 maximum: 600 in: query name: active_within_months required: false description: >- 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. - schema: type: integer minimum: 1 maximum: 1000000 in: query name: investor_deals_min required: false description: >- Minimum purchase events of that investor inside the geometry, 1 to 1,000,000. The API applies it after the other filters. - schema: type: integer minimum: 0 maximum: 1000000 in: query name: holds_min required: false description: >- 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. - schema: type: integer minimum: 0 maximum: 1000000 in: query name: holds_max required: false description: >- 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. - schema: type: string enum: - 'true' - 'false' in: query name: buys_wholesale required: false description: >- Investor filter: at least one bought-from-wholesaler deal in the 36 months before data_end. - schema: type: string enum: - 'true' - 'false' in: query name: buys_at_auction required: false description: >- 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). - schema: type: string enum: - 'true' - 'false' in: query name: buys_reo required: false description: >- 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. - schema: minItems: 1 type: array items: type: string enum: - TRUSTEE_SALE - SHERIFF_SALE - HOA_TRUSTEE_SALE - TAX_SALE - TAX_LIEN_DEED description: >- 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. in: query name: bought_auction_kind required: false description: >- 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. - schema: type: string enum: - 'true' - 'false' in: query name: bought_from_wholesaler required: false description: >- 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. - schema: type: string enum: - 'true' - 'false' in: query name: bought_distressed required: false description: >- 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. - schema: type: string enum: - 'true' - 'false' in: query name: registered_only required: false description: >- Keep only rows whose buyer carries an investor id (investor.id is not null). - schema: minItems: 1 type: array items: type: string enum: - registered - unclassified - excluded - unknown description: >- 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. in: query name: buyer_status required: false description: Buyer statuses to keep. - schema: type: string enum: - 'true' - 'false' in: query name: str_operator required: false description: >- 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). - schema: type: integer minimum: 1 maximum: 100000 in: query name: str_holdings_min required: false description: >- 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. - schema: type: string pattern: ^len_[0-9a-f]{12}$ in: query name: financed_by required: false description: >- 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). - schema: type: string enum: - 'true' - 'false' in: query name: uses_private_lender required: false description: >- 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. - schema: type: string pattern: ^inv_[0-9a-f]{12}$ in: query name: investor_id required: false description: >- 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. - schema: type: string pattern: ^deal_[0-9a-f]{32}$ in: query name: deal_id required: false description: Scope the rows to one deal. - schema: type: number minimum: -90 maximum: 90 in: query name: lat required: false description: >- Point latitude (with lng). With radius_miles it is the search geometry. With bbox it is the reference point only. - schema: type: number minimum: -180 maximum: 180 in: query name: lng required: false description: Point longitude (with lat). - schema: type: number minimum: 0.25 maximum: 20 in: query name: radius_miles required: false description: >- 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. - schema: type: string in: query name: bbox required: false description: >- 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. - schema: type: string pattern: ^prop_[0-9a-f]{32}$ in: query name: property_id required: false description: >- Parcel geometry: search around the centre of that parcel, with radius_miles. Not allowed with lat, lng or bbox. - schema: minItems: 1 maxItems: 50 type: array items: type: string pattern: ^\d{5}$ in: query name: zip required: false description: >- 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). - schema: type: string minLength: 1 maxLength: 100 in: query name: city required: false description: >- 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. - schema: type: integer minimum: 1 maximum: 9007199254740991 in: query name: subject_asking_price required: false description: >- The contract or asking price of the subject deal, whole dollars, for example 250000. Send it only when the deal has an asking price. It feeds the price_fit factor and never filters deals. - schema: type: integer minimum: 1 maximum: 9007199254740991 in: query name: subject_arv required: false description: >- After-repair value of the subject, whole dollars, for example 560000. Send it only when it is known and above 0. Without an asking price it drives price_fit through the buy-to-resale ratio of the investor, or else the ratio of the metro (meta.coverage[].metro_buy_to_resale_ratio). It also enables the resale_fit reason (weight 0 by default). - schema: type: string enum: - TURN_KEY - LIGHT_REHAB - MAJOR_REHAB - FULL_GUT - TEAR_DOWN in: query name: subject_condition required: false description: >- Condition of the subject property, the Investorlift enum. TURN_KEY: move-in ready, where landlords and iBuyers fit best. LIGHT_REHAB: cosmetic work, for flippers and landlords. MAJOR_REHAB and FULL_GUT: heavy work, flippers first and builders next. TEAR_DOWN: a lot, builders first. It drives the strategy factor: if you omit it, the API drops that factor. - schema: type: string enum: - SFR - CONDO_TH - OTHER in: query name: subject_segment required: false description: >- Segment of the subject property: SFR, CONDO_TH (condo or townhouse) or OTHER. OTHER is a mixed bucket: manufactured, multi-family, land and commercial. The subject segment drives the segment factor, the share of the deals of the investor in this segment. It defaults from the parcel when the geometry is property_id. Otherwise omit it and the API drops the factor. Investorlift mapping: single_family maps to SFR, condo and townhouse map to CONDO_TH, and everything else maps to OTHER. - schema: type: integer minimum: 0 maximum: 50 in: query name: subject_beds required: false description: >- Bedrooms of the subject, for example 3. It defaults from the parcel when the geometry is property_id. The API accepts and echoes it for forward compatibility and does not score it in this version. - schema: type: integer minimum: 1 maximum: 9007199254740991 in: query name: subject_sqft required: false description: >- Living area of the subject in square feet, for example 1650. It defaults from the parcel when the geometry is property_id. The API accepts and echoes it for forward compatibility and does not score it in this version. - schema: type: number minimum: 0 maximum: 1 in: query name: w_proximity required: false description: >- Weight of the proximity factor, 0 to 1 (default 0.3). Proximity: how many separate purchase days they had near the subject and how close. - schema: type: number minimum: 0 maximum: 1 in: query name: w_recency required: false description: >- Weight of the recency factor, 0 to 1 (default 0.25). Recency: how close to the deed data end (meta.coverage[].data_end) they last bought, and how often they buy. - schema: type: number minimum: 0 maximum: 1 in: query name: w_price_fit required: false description: >- Weight of the price_fit factor, 0 to 1 (default 0.2). Price fit: if the subject price sits inside what they usually pay. Needs subject_asking_price or subject_arv. - schema: type: number minimum: 0 maximum: 1 in: query name: w_strategy required: false description: >- Weight of the strategy factor, 0 to 1 (default 0.1). Strategy: if their kinds suit the subject condition. Needs subject_condition. - schema: type: number minimum: 0 maximum: 1 in: query name: w_segment required: false description: >- Weight of the segment factor, 0 to 1 (default 0.05). Segment: the share of their deals in the subject segment. Needs subject_segment or property_id. - schema: type: number minimum: 0 maximum: 1 in: query name: w_wholesale_buyer required: false description: >- Weight of the wholesale_buyer factor, 0 to 1 (default 0.1). Wholesale buyer: how many documented wholesale purchases they made in the 5 years ending on the deed data end (meta.coverage[].data_end). - schema: type: number minimum: 0 maximum: 1 in: query name: w_resale_fit required: false description: >- Weight of the resale_fit factor, 0 to 1 (default 0). Resale fit: the subject ARV against their median flip resale. Needs subject_arv. The default is 0, so the API shows the reason without moving the score. - schema: type: number minimum: 0 maximum: 1 in: query name: w_activity required: false description: >- Weight of the activity signal, 0 to 1 (default 0: off), not part of reasons[] or meta.weights. The API multiplies the score by the probability that the operator buys in the 180 days after the data end (buyer_signal.activity_p_180), raised to this power. A power of 1 ranks by expected purchases, 0.5 softens the effect, and 0 leaves the ranking as it is. Any change starts a new ranking and invalidates the cursor, and the activity_multiplier of the row shows what the signal did. An investor with no probability, a dormant operator or one with no signal row, scores as 0.034, the measured dormant re-activation rate. In the Phoenix measurement 3.4% of dormant operators bought again within 180 days. - schema: type: string enum: - 'true' - 'false' in: query name: include_unregistered required: false description: >- Add summary.unregistered[]: the id-less buyers inside the geometry, households and unclassified names that bought here. The API scores them on proximity and recency only. A lead list, not a ranking: most have one deal. - schema: type: string enum: - 'true' - 'false' in: query name: include_excluded required: false description: >- With include_unregistered=true, also list the excluded buyers: custodian trusts, relocation companies, auction houses and ambiguous surnames. Default false. - schema: default: 100 type: integer minimum: 1 maximum: 200 in: query name: limit required: false description: Page size, 1-200 (default 100). - schema: type: string minLength: 1 maxLength: 4096 in: query name: cursor required: false description: >- 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. responses: '200': description: >- Ranked buyers, best first, with reasons; summary for the whole area; meta.weights and meta.reference_point. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/BuyerMatch' description: The rows of this page. page: $ref: '#/components/schemas/Page' meta: $ref: '#/components/schemas/Meta' summary: $ref: '#/components/schemas/MatchSummary' required: - data - page - meta - summary additionalProperties: false description: >- Ranked buyers, best first, with reasons; summary for the whole area; meta.weights and meta.reference_point. example: data: - investor: id: inv_70f5dd32e592 market: phx name: SALT RIVER EQUITY LLC display_name: SALT RIVER EQUITY LLC state: AZ kind: FLIPPER confidence: STRONG scale: large institutional: false is_public: false last_bought_on: '2026-08-06' n_deals: 1581 buyer_status: registered kinds: - FLIPPER - BUILDER - WHOLESALER - LANDLORD days_since_last_purchase: 6 n_purchase_events_12m: 99 n_purchase_events_24m: 180 n_flips: 130 n_wholesales: 1206 n_holds: 97 n_long_holds: 33 n_bought_from_wholesaler_5y: 41 price_band: window: 5y p25: 235000 p50: 325000 p75: 442875 n_priced_purchases: 642 p50_flip_sold_price: 347500 segment_mix: sfr: 0.854 condo_th: 0.094 other: 0.052 has_person_member: true has_home_address: true has_suite_address: true member_names: - SALT RIVER EQUITY LLC - MMAR HOLDINGS LLC - ML SQUARED REAL ESTATE INVESTMENT LLC - SICK HOMES LLC - LLC SALT RIVER EQUITY - THERESA ORTIZ TRUST operator_id: inv_70f5dd32e592 n_operator_members: 6 auction: n_auction_buys: 0 n_auction_buys_24m: 0 last_auction_buy_on: null is_active_auction_buyer: false auction_resale_share: null n_reo_buys: 11 n_reo_buys_24m: 3 last_reo_buy_on: '2026-06-30' is_active_reo_buyer: true in_radius: n_events: 91 n_purchase_events: 86 n_parcels: 91 n_held_parcels: 4 n_flips: 4 n_holds: 4 n_long_holds: 3 volume: 36531443 last_bought_on: '2026-06-11' last_deal_on: '2026-06-11' nearest_distance_miles: 0.2 median_bought_price: 337000 n_unpriced: 0 n_undated: 0 score: 0.9901 gate: 1 base_score: 0.9901 activity_multiplier: 1 reasons: - factor: proximity weight: 0.3 value: 0.9995 detail: 86 purchases (91 parcels) within 2 mi, nearest 0.20 mi - factor: recency weight: 0.25 value: 0.9902 detail: >- last bought 6 days before the data's end date (2026-08-12); 180 purchase events in 24 months - factor: price_fit weight: 0.2 value: 1 detail: >- $250k sits inside their 5-year band $235k-$443k (642 priced purchases) - factor: strategy weight: 0.1 value: 1 detail: FLIPPER (STRONG); subject is MAJOR_REHAB - factor: segment weight: 0.05 value: 0.854 detail: 85% of their deals are SFR - factor: wholesale_buyer weight: 0.1 value: 1 detail: bought 41 wholesale contracts since 2021, last 2026-03 sample_deals: - id: deal_0d12db603fd2fbf20a5524060c588a6f kind: wholesale address_short: 2840 N 74th Pl latitude: 33.479621 longitude: -111.92165 bought_on: '2019-08-07' bought_price: 337000 sold_on: '2019-08-08' sold_price: 357500 gross_profit: 20500 distance_miles: 0.2 bought_from_wholesaler: false bought_distressed: false bought_auction_kind: null - id: deal_6ab665cf87971af3b20d75d5ee6061d6 kind: wholesale address_short: 7232 E Virginia Ave latitude: 33.477346 longitude: -111.924674 bought_on: '2018-08-20' bought_price: 330000 sold_on: '2018-08-24' sold_price: 349900 gross_profit: 19900 distance_miles: 0.25 bought_from_wholesaler: false bought_distressed: false bought_auction_kind: null buyer_signal: operator_id: inv_70f5dd32e592 n_operator_members: 6 operator_member_ids: - inv_0dccd79162e9 - inv_178f7fd9aae5 - inv_50c0fb39bd5e - inv_57a71d3e5b88 - inv_70f5dd32e592 - inv_712425783c9f is_anchor: true merge_confidence: MERGED_STRONG activity_p_180: 0.937516 activity_p_365: 0.965902 cell_n: 1599 activity_model: CYCLE_v1 cycle_state: FRESH_CASH capital_freed_60d: true days_since_last_purchase: 6 days_since_last_resale: 7 open_inventory: 88 n_purchases_36m: 373 median_gap_days: 3 share_within_30d_of_resale: 0.9991 data_end: '2026-08-12' listings: n_active: 8 n_pending: 0 n_listed: 8 n_listed_undated: 0 n_holdings_dated: 97 n_holdings_undated: 0 median_list_price: 527500 min_list_price: 239900 max_list_price: 754900 last_listed_on: '2026-08-23' n_listed_12m: 27 listings_data_end: '2026-08-31' wholesale_purchases: 'n': 6 n_12m: 0 n_24m: 3 n_5y: 6 n_probable: 4 last_on: '2025-04-30' n_wholesalers: 4 top_wholesalers: - id: wsr_a7c0d7da9bc7 name: National Property Superstore 'n': 2 - id: wsr_b847c1c64247 name: Freedom Ventures 'n': 2 - id: wsr_4a4468db0919 name: TTP AZ, LLC 'n': 1 n_double_closed: 1 median_asking_price: 309950 data_end: '2026-08-12' str: null - investor: id: inv_a61331a35b68 market: phx name: BLACK CANYON EQUITY LLC display_name: BLACK CANYON EQUITY LLC state: AZ kind: FLIPPER confidence: STRONG scale: large institutional: false is_public: false last_bought_on: '2026-07-30' n_deals: 1354 buyer_status: registered kinds: - FLIPPER - BUILDER - WHOLESALER - LANDLORD days_since_last_purchase: 13 n_purchase_events_12m: 70 n_purchase_events_24m: 125 n_flips: 126 n_wholesales: 881 n_holds: 154 n_long_holds: 83 n_bought_from_wholesaler_5y: 140 price_band: window: 5y p25: 270000 p50: 345000 p75: 450000 n_priced_purchases: 926 p50_flip_sold_price: 471500 segment_mix: sfr: 0.832 condo_th: 0.123 other: 0.044 has_person_member: true has_home_address: true has_suite_address: true member_names: - BLACK CANYON EQUITY LLC - BAF 3 LLC - OHANA43 LLC - SVH ENTERPRISES LLC - LLC BLACK CANYON EQUITY - BLACK CANYON LLC operator_id: inv_a61331a35b68 n_operator_members: 12 auction: n_auction_buys: 1 n_auction_buys_24m: 0 last_auction_buy_on: '2019-01-03' is_active_auction_buyer: false auction_resale_share: null n_reo_buys: 2 n_reo_buys_24m: 1 last_reo_buy_on: '2026-02-18' is_active_reo_buyer: true in_radius: n_events: 123 n_purchase_events: 112 n_parcels: 117 n_held_parcels: 7 n_flips: 16 n_holds: 7 n_long_holds: 9 volume: 55249200 last_bought_on: '2026-07-20' last_deal_on: '2026-07-23' nearest_distance_miles: 0.16 median_bought_price: 453000 n_unpriced: 0 n_undated: 0 score: 0.982 gate: 1 base_score: 0.982 activity_multiplier: 1 reasons: - factor: proximity weight: 0.3 value: 1 detail: >- 112 purchases (117 parcels) within 2 mi, nearest 0.16 mi - factor: recency weight: 0.25 value: 0.979 detail: >- last bought 13 days before the data's end date (2026-08-12); 125 purchase events in 24 months - factor: price_fit weight: 0.2 value: 0.9783 detail: >- $250k is below their 5-year band $270k-$450k (926 priced purchases) - factor: strategy weight: 0.1 value: 1 detail: FLIPPER (STRONG); subject is MAJOR_REHAB - factor: segment weight: 0.05 value: 0.832 detail: 83% of their deals are SFR - factor: wholesale_buyer weight: 0.1 value: 1 detail: >- bought 140 wholesale contracts since 2021, last 2026-07 sample_deals: - id: deal_9f8cc43ff573113c256bb52279230924 kind: long_hold address_short: 2615 N 73rd Pl latitude: 33.477329 longitude: -111.923155 bought_on: '2022-02-14' bought_price: 540000 sold_on: '2023-05-31' sold_price: 985000 gross_profit: 445000 distance_miles: 0.16 bought_from_wholesaler: true bought_distressed: false bought_auction_kind: null - id: deal_47a476cc378e6a763a8e393e5b6671d8 kind: long_hold address_short: 2539 N Miller Rd latitude: 33.47629 longitude: -111.916233 bought_on: '2023-03-20' bought_price: 500000 sold_on: '2024-08-07' sold_price: 705000 gross_profit: 205000 distance_miles: 0.24 bought_from_wholesaler: false bought_distressed: false bought_auction_kind: null buyer_signal: operator_id: inv_a61331a35b68 n_operator_members: 12 operator_member_ids: - inv_0dd5a869408e - inv_3d5d38784610 - inv_485a7f48c46c - inv_4d70fe04c768 - inv_5d77474fe9f4 - inv_6740053846a1 - inv_698381652192 - inv_6aa6e7ca9558 - inv_a61331a35b68 - inv_a8ed7cb4612d - inv_cc1d95252d89 - inv_d8abe8e7314e is_anchor: true merge_confidence: MERGED_STRONG activity_p_180: 0.937516 activity_p_365: 0.965902 cell_n: 1599 activity_model: CYCLE_v1 cycle_state: FRESH_CASH capital_freed_60d: true days_since_last_purchase: 13 days_since_last_resale: 8 open_inventory: 201 n_purchases_36m: 223 median_gap_days: 2 share_within_30d_of_resale: 0.9309 data_end: '2026-08-12' listings: n_active: 7 n_pending: 0 n_listed: 7 n_listed_undated: 0 n_holdings_dated: 154 n_holdings_undated: 0 median_list_price: 359900 min_list_price: 335000 max_list_price: 399900 last_listed_on: '2026-08-08' n_listed_12m: 25 listings_data_end: '2026-08-31' wholesale_purchases: 'n': 12 n_12m: 3 n_24m: 6 n_5y: 11 n_probable: 7 last_on: '2025-11-26' n_wholesalers: 11 top_wholesalers: - id: wsr_7b407f79e351 name: KeyGlee 'n': 2 - id: wsr_37e2a3dcdf4c name: Home Team Investors 'n': 1 - id: wsr_435f4f5439c2 name: EZAZ Homes 'n': 1 n_double_closed: 4 median_asking_price: 394245 data_end: '2026-08-12' str: null - investor: id: inv_4a8213dc5193 market: phx name: WHITE FIG HOMES JV LLC display_name: WHITE FIG HOMES JV LLC state: AZ kind: LANDLORD confidence: STRONG scale: large institutional: false is_public: false last_bought_on: '2026-08-07' n_deals: 1099 buyer_status: registered kinds: - LANDLORD - FLIPPER - BUILDER - WHOLESALER days_since_last_purchase: 5 n_purchase_events_12m: 99 n_purchase_events_24m: 206 n_flips: 804 n_wholesales: 67 n_holds: 146 n_long_holds: 32 n_bought_from_wholesaler_5y: 56 price_band: window: 5y p25: 226000 p50: 283000 p75: 365000 n_priced_purchases: 577 p50_flip_sold_price: 365000 segment_mix: sfr: 0.845 condo_th: 0.119 other: 0.035 has_person_member: true has_home_address: true has_suite_address: true member_names: - WHITE FIG HOMES JV LLC - WHITE FIG HOMES LLC - BENE HOLDINGS LLC - MARINA INVESTMENTS LLC - WF3 LLC - NEB PROPERTIES LLC operator_id: inv_4a8213dc5193 n_operator_members: 9 auction: n_auction_buys: 0 n_auction_buys_24m: 0 last_auction_buy_on: null is_active_auction_buyer: false auction_resale_share: null n_reo_buys: 2 n_reo_buys_24m: 0 last_reo_buy_on: '2016-01-19' is_active_reo_buyer: false in_radius: n_events: 31 n_purchase_events: 28 n_parcels: 31 n_held_parcels: 8 n_flips: 13 n_holds: 8 n_long_holds: 3 volume: 8914650 last_bought_on: '2025-08-11' last_deal_on: '2026-02-10' nearest_distance_miles: 0.17 median_bought_price: 293000 n_unpriced: 1 n_undated: 0 score: 0.9525 gate: 1 base_score: 0.9525 activity_multiplier: 1 reasons: - factor: proximity weight: 0.3 value: 0.8744 detail: 28 purchases (31 parcels) within 2 mi, nearest 0.17 mi - factor: recency weight: 0.25 value: 0.9918 detail: >- last bought 5 days before the data's end date (2026-08-12); 206 purchase events in 24 months - factor: price_fit weight: 0.2 value: 1 detail: >- $250k sits inside their 5-year band $226k-$365k (577 priced purchases) - factor: strategy weight: 0.1 value: 1 detail: FLIPPER (STRONG); subject is MAJOR_REHAB - factor: segment weight: 0.05 value: 0.845 detail: 85% of their deals are SFR - factor: wholesale_buyer weight: 0.1 value: 1 detail: bought 56 wholesale contracts since 2021, last 2026-07 sample_deals: - id: deal_061642c8e4360c1974211049d19516e4 kind: hold address_short: 7312 E Wilshire Dr latitude: 33.476506 longitude: -111.923264 bought_on: '2016-05-12' bought_price: 235000 sold_on: null sold_price: null gross_profit: null distance_miles: 0.17 bought_from_wholesaler: false bought_distressed: false bought_auction_kind: null - id: deal_30127834d445faab36b4f32b243b600b kind: hold address_short: 2245 N 72nd Pl latitude: 33.472551 longitude: -111.924486 bought_on: '2019-02-28' bought_price: 354900 sold_on: null sold_price: null gross_profit: null distance_miles: 0.38 bought_from_wholesaler: true bought_distressed: false bought_auction_kind: null buyer_signal: operator_id: inv_4a8213dc5193 n_operator_members: 9 operator_member_ids: - inv_1629e9057de3 - inv_20bf030f2d84 - inv_22ae900021c2 - inv_2e162d00a074 - inv_3adb82477f3f - inv_4a8213dc5193 - inv_684790efabe8 - inv_888becfdd422 - inv_8aae0f1c5460 is_anchor: true merge_confidence: MERGED_STRONG activity_p_180: 0.937516 activity_p_365: 0.965902 cell_n: 1599 activity_model: CYCLE_v1 cycle_state: FRESH_CASH capital_freed_60d: true days_since_last_purchase: 5 days_since_last_resale: 16 open_inventory: 134 n_purchases_36m: 556 median_gap_days: 3 share_within_30d_of_resale: 0.989 data_end: '2026-08-12' listings: n_active: 16 n_pending: 5 n_listed: 21 n_listed_undated: 0 n_holdings_dated: 146 n_holdings_undated: 0 median_list_price: 469900 min_list_price: 234900 max_list_price: 995000 last_listed_on: '2026-08-27' n_listed_12m: 47 listings_data_end: '2026-08-31' wholesale_purchases: 'n': 60 n_12m: 7 n_24m: 34 n_5y: 60 n_probable: 30 last_on: '2026-07-28' n_wholesalers: 17 top_wholesalers: - id: wsr_cf9dfee7cc0a name: Andrew The Home Buyer LLC 'n': 15 - id: wsr_b847c1c64247 name: Freedom Ventures 'n': 8 - id: wsr_a7c0d7da9bc7 name: National Property Superstore 'n': 7 n_double_closed: 2 median_asking_price: 325700 data_end: '2026-08-12' str: null page: next_cursor: >- eyJ2IjoxLCJydW4iOiIxNzg4NTIxODM0IiwicSI6ImJiNTJlNjZmNjRkMzliYmI3YTRmOThmOGRlMDViM2I0MWRiODVjOTExNDllZTBkYjVmMTc3NTY4MTA5ZDQ2OGQiLCJrIjpbMC45NTI1MzMzNDc1NjIzNzA3LCJpbnZfNGE4MjEzZGM1MTkzIl19 limit: 3 returned: 3 meta: generated_at: '2026-09-04T12:00:00.000Z' weights: proximity: 0.3 recency: 0.25 price_fit: 0.2 strategy: 0.1 segment: 0.05 wholesale_buyer: 0.1 resale_fit: 0 reference_point: lat: 33.476917 lng: -111.920385 geometry: kind: radius lat: 33.476917 lng: -111.920385 radius_miles: 2 bbox: null property_id: null zip: null city: null coverage: - market: phx state: AZ counties: - fips: '04013' name: Maricopa data_end: '2026-08-12' - fips: '04021' name: Pinal data_end: '2026-08-06' bbox: - -113.332773 - 32.46915 - -110.455491 - 33.999503 data_end: '2026-08-12' build_run_id: 1 registry_run: 8 registry_version: v4-metro-review-fixes dataset_version: 1788521834 loaded_at: '2026-09-04T11:37:14.263Z' metro_buy_to_resale_ratio: 0.7192 universe_kind: metro universe_zips: null point_tolerance_miles: 20 n_parcels: 1836307 listings_data_end: '2026-08-31' agents_data_end: '2026-08-31' wholesale_as_of: '2026-09-09' str_as_of: null str: null auction_counted: true parcel_as_of: null address_as_of: null parcel: null lenders: null terms: >- Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms summary: by_buyer_status: registered: 10678 unclassified: 208 excluded: 65 unknown: 7 n_investors_ranked: 5813 n_unpriced: 1975 n_undated: 27 headers: ETag: $ref: '#/components/headers/ETag' X-Request-Id: $ref: '#/components/headers/X-Request-Id' X-Rows: $ref: '#/components/headers/X-Rows' X-Dataset-Version: $ref: '#/components/headers/X-Dataset-Version' X-Data-End: $ref: '#/components/headers/X-Data-End' X-Credits-Charged: $ref: '#/components/headers/X-Credits-Charged' X-Credits-Remaining: $ref: '#/components/headers/X-Credits-Remaining' '400': description: >- Bad request (dataset_unavailable, geometry_conflict, geometry_required, invalid_cursor, invalid_id, market_required, quicklist_unavailable, sort_requires_point, unknown_parameter, validation_error) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: geometry_conflict: summary: Geometry conflict value: type: >- https://developers.investorlift.com/guides/concepts/errors#geometry_conflict title: Geometry conflict status: 400 code: geometry_conflict detail: >- You cannot combine radius_miles with bbox. Send one geometry only. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 geometry_required: summary: Geometry required value: type: >- https://developers.investorlift.com/guides/concepts/errors#geometry_required title: Geometry required status: 400 code: geometry_required detail: >- The request needs one geometry: lat and lng with radius_miles, bbox, property_id, zip (a list) or city. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 invalid_cursor: summary: Invalid cursor value: type: >- https://developers.investorlift.com/guides/concepts/errors#invalid_cursor title: Invalid cursor status: 400 code: invalid_cursor detail: >- The API issued the cursor for another query. Restart from page 1. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 invalid_id: summary: Invalid id value: type: >- https://developers.investorlift.com/guides/concepts/errors#invalid_id title: Invalid id status: 400 code: invalid_id detail: >- An investor id is inv_ followed by 12 hex characters. The prefix is part of the id. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 market_required: summary: Market required value: type: >- https://developers.investorlift.com/guides/concepts/errors#market_required title: Market required status: 400 code: market_required detail: >- inv_0a20a550f33b exists in 2 loaded markets. Pass market=. The codes are in markets[]. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 markets: - phx - hou errors: - param: market message: one of phx, hou code: market_required sort_requires_point: summary: Sort requires a reference point value: type: >- https://developers.investorlift.com/guides/concepts/errors#sort_requires_point title: Sort requires a reference point status: 400 code: sort_requires_point detail: >- sort=distance needs a reference point: add lat and lng, or property_id. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 unknown_parameter: summary: Unknown parameter value: type: >- https://developers.investorlift.com/guides/concepts/errors#unknown_parameter title: Unknown parameter status: 400 code: unknown_parameter detail: >- The query carries a parameter this endpoint does not define: kind[]. Write the list as kind=flip,hold or as repeated keys. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 errors: - param: kind[] message: unknown parameter code: unknown_parameter validation_error: summary: Validation error value: type: >- https://developers.investorlift.com/guides/concepts/errors#validation_error title: Validation error status: 400 code: validation_error detail: radius_miles must be 20 or less. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 errors: - param: radius_miles message: must be 20 or less code: too_big headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '401': description: Unauthorized (unauthorized) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: unauthorized: summary: Unauthorized value: type: >- https://developers.investorlift.com/guides/concepts/errors#unauthorized title: Unauthorized status: 401 code: unauthorized detail: 'Send Authorization: Bearer with a current key.' instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '403': description: >- Forbidden (payment_overdue, plan_limit, quota_exceeded, subscription_required) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: plan_limit: summary: Plan limit value: type: >- https://developers.investorlift.com/guides/concepts/errors#plan_limit title: Plan limit status: 403 code: plan_limit detail: >- The free plan searches within 5 miles of a point, a viewport up to 10 miles across, or one ZIP code. Your zip parameter lists 2 ZIP codes. Upgrade in the developer console for city-wide and multi-ZIP searches. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 tier: free limit: geometry max_radius_miles: 5 max_bbox_diagonal_miles: 10 max_zips: 1 quota_exceeded: summary: Quota exceeded value: type: >- https://developers.investorlift.com/guides/concepts/errors#quota_exceeded title: Quota exceeded status: 403 code: quota_exceeded detail: >- Your requests spent the plan's credits for this billing period (5000 of 5000). Wait for the period to reset on the subscription's billing date, or upgrade in the developer console. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 used: 5000 line: 5000 subscription_required: summary: Subscription required value: type: >- https://developers.investorlift.com/guides/concepts/errors#subscription_required title: Subscription required status: 403 code: subscription_required detail: >- This key has no active plan subscription. Subscribe in the developer console. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 payment_overdue: summary: Payment overdue value: type: >- https://developers.investorlift.com/guides/concepts/errors#payment_overdue title: Payment overdue status: 403 code: payment_overdue detail: >- The subscription's payment is overdue and the grace period passed. Update the card under Manage Billing in the developer console. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '404': description: Not found (not_found) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: not_found: summary: Not found value: type: >- https://developers.investorlift.com/guides/concepts/errors#not_found title: Not found status: 404 code: not_found detail: No such deal in any loaded market. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '406': description: Not acceptable (not_acceptable) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: not_acceptable: summary: Not acceptable value: type: >- https://developers.investorlift.com/guides/concepts/errors#not_acceptable title: Not acceptable status: 406 code: not_acceptable detail: >- Accept text/html names no representation this endpoint produces (application/json). instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '410': description: >- Gone: a retired investor, agent or lender id, with superseded_by (gone) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: gone: summary: Gone value: type: >- https://developers.investorlift.com/guides/concepts/errors#gone title: Gone status: 410 code: gone detail: >- The registry retired investor inv_003c1db2782c in run 8 (RETIRED). No current investor holds its names. Use /v1/investors/search instead. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 superseded_by: null reason: RETIRED market: phx headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '422': description: >- Unprocessable (addresses_unavailable, agents_unavailable, ambiguous_address, ambiguous_apn, auction_unavailable, cash_sale_unavailable, dated_refused, history_unavailable, lenders_unavailable, listings_unavailable, outside_coverage, parcels_unavailable, str_unavailable, wholesale_unavailable) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: agents_unavailable: summary: Agents unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#agents_unavailable title: Agents unavailable status: 422 code: agents_unavailable detail: >- This market has no published agent registry. See meta.coverage[].agents_data_end. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 auction_unavailable: summary: Auction counts unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#auction_unavailable title: Auction counts unavailable status: 422 code: auction_unavailable detail: >- This market has no published foreclosure-auction counts: its registry predates them. So the API cannot answer buys_at_auction, buys_reo and bought_auction_kind there, and meta.coverage[].auction_counted is false for it. Drop the parameter to list every row. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 lenders_unavailable: summary: Lenders unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#lenders_unavailable title: Lenders unavailable status: 422 code: lenders_unavailable detail: >- Market hou has no published lender registry (meta.coverage[].lenders is null there). The API still serves the financing block on parcels where the slice is. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 markets: - hou listings_unavailable: summary: Listings unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#listings_unavailable title: Listings unavailable status: 422 code: listings_unavailable detail: >- You gave listing_status for a market with no published listing tables. See meta.coverage[].listings_data_end. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 outside_coverage: summary: Outside coverage value: type: >- https://developers.investorlift.com/guides/concepts/errors#outside_coverage title: Outside coverage status: 422 code: outside_coverage detail: >- The point 40.712776, -74.005974 is outside every loaded market's point tolerance (loaded: phx, hou). See meta.coverage[].bbox and point_tolerance_miles on any list response. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 str_unavailable: summary: Short-term rental data unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#str_unavailable title: Short-term rental data unavailable status: 422 code: str_unavailable detail: >- This market has no published short-term rental tables. See meta.coverage[].str_as_of. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 wholesale_unavailable: summary: Wholesale transactions unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#wholesale_unavailable title: Wholesale transactions unavailable status: 422 code: wholesale_unavailable detail: >- This market has no published Investorlift wholesale tables. See meta.coverage[].wholesale_as_of. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '429': description: Rate limited, with Retry-After (rate_limited) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: rate_limited: summary: Rate limited value: type: >- https://developers.investorlift.com/guides/concepts/errors#rate_limited title: Rate limited status: 429 code: rate_limited detail: >- The request exceeded the per-key budget. Retry in 12 seconds. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 retry_after: 12 bucket: key headers: Retry-After: $ref: '#/components/headers/Retry-After' X-Request-Id: $ref: '#/components/headers/X-Request-Id' '500': description: Internal error (internal_error) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: internal_error: summary: Internal error value: type: >- https://developers.investorlift.com/guides/concepts/errors#internal_error title: Internal error status: 500 code: internal_error detail: The request failed. Quote request_id when you report it. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '503': description: >- Unavailable, with Retry-After on pool_saturated and ledger_unavailable (database_unavailable, ledger_unavailable, pool_saturated) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: database_unavailable: summary: Database unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#database_unavailable title: Database unavailable status: 503 code: database_unavailable detail: >- The service failed to reach the database and did not run the request. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 ledger_unavailable: summary: Ledger unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#ledger_unavailable title: Ledger unavailable status: 503 code: ledger_unavailable detail: >- The credit ledger is unreachable. The API charged nothing. Retry in 5 seconds. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 retry_after: 5 pool_saturated: summary: Pool saturated value: type: >- https://developers.investorlift.com/guides/concepts/errors#pool_saturated title: Pool saturated status: 503 code: pool_saturated detail: >- No pooled connection was free. The service did not run the request. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: Retry-After: $ref: '#/components/headers/Retry-After' X-Request-Id: $ref: '#/components/headers/X-Request-Id' '504': description: Statement timeout (statement_timeout) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: statement_timeout: summary: Statement timeout value: type: >- https://developers.investorlift.com/guides/concepts/errors#statement_timeout title: Statement timeout status: 504 code: statement_timeout detail: >- The query exceeded the 10 second statement timeout. Narrow the geometry or filters. instance: /v1/buyers/match request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' components: schemas: BuyerMatch: type: object properties: investor: $ref: '#/components/schemas/InvestorListItem' description: >- Who the buyer is and what they do across the market, with member_names[] for the name join. in_radius: $ref: '#/components/schemas/InRadius' score: type: number description: >- Fit for the subject, 0 to 1, best first, rounded to 4 decimals: base_score x activity_multiplier. With the default w_activity=0 the multiplier is 1 and score equals base_score, gate x the weighted mean of the factor values in reasons[]. Compare within one response only. A different subject, radius, weight set or w_activity is a different scale. gate: type: number description: >- 1 when the investor bought in the last 3 years before the data end date. 0.5 otherwise, which includes an investor that never bought. The API multiplies the score by it, so a dormant investor never outranks an active one with the same factors. base_score: type: number description: >- The score before the activity signal, 0 to 1, rounded to 4 decimals: gate x sum(weight x value) over reasons[]. The weights sum to 1. activity_multiplier: type: number description: >- What the activity signal did to the score, 0.01 to 1, rounded to 4 decimals: buyer_signal.activity_p_180 raised to the power w_activity. When that probability is null, the API uses the dormant rate the w_activity parameter documents. 1 with the default w_activity=0. The formula is score = base_score x activity_multiplier. reasons: type: array items: $ref: '#/components/schemas/MatchReason' description: >- One entry per factor the API can score, in plan order: proximity, recency, price_fit, strategy, segment, wholesale_buyer, resale_fit. A factor without its input is absent, and the API redistributes its weight. Such an input is an asking price, a condition or priced purchases. The activity signal is not a factor and has no entry. Show detail to the user as it is. sample_deals: type: array items: $ref: '#/components/schemas/SampleDeal' description: >- Up to 5 of their deals inside the geometry. Nearest first, or newest first when the request has no reference point. They are the proof shown under the row. id opens `/v1/deals/{id}`. buyer_signal: anyOf: - $ref: '#/components/schemas/BuyerSignal' - type: 'null' description: >- The operator this investor belongs to (investor.operator_id), its capital cycle and its probability of buying in the next 180 days after the data end. Served to every key. Null for a market without a built buyer signal, and when the investor has no signal row. listings: anyOf: - $ref: '#/components/schemas/InvestorListings' - type: 'null' description: >- What the investor has on the market right now, measured at listings_data_end: their holdings listed ACTIVE or PENDING in the MLS feed. Not a factor of the score. Served to every key. Null for a market without published listing tables. Zeros when the market has them and nothing is listed. wholesale_purchases: anyOf: - $ref: '#/components/schemas/InvestorWholesale' - type: 'null' description: >- What the investor bought off Investorlift listings per the recorded deeds: counts by window, the last one and the companies they buy from. Not a factor of the score. Served to every key. Null for a market without published wholesale tables. Zeros when the market has them and the investor never bought one. str: anyOf: - $ref: '#/components/schemas/InvestorStr' - type: 'null' description: >- How many holdings of the investor carry a business-use short-term-rental licence attributed to them, from the rolls of the cities. Not a factor of the score. Served to every key. Null for a market without published short-term rental tables. Zeros when the market has them and the investor holds no such parcel. required: - investor - in_radius - score - gate - base_score - activity_multiplier - reasons - sample_deals - buyer_signal - listings - wholesale_purchases - str description: One ranked buyer for the subject property. Page: type: object properties: next_cursor: description: >- Opaque cursor for the next page: pass it back as cursor= with the same query. Null on the last page. type: - string - 'null' limit: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The page size the API applied. returned: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Rows in this page. required: - next_cursor - limit - returned additionalProperties: false description: >- Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does. Meta: type: object properties: generated_at: type: string description: >- When the API produced this response, ISO 8601. It does not change the ETag. weights: description: >- The effective match weights, one per factor, rounded to 4 decimals (buyers/match only). The API rescales the weights of the scored factors to sum 1 before it reports them. type: object propertyNames: type: string additionalProperties: type: number reference_point: description: >- The point the API measures every distance in the response from: lat + lng, or the centre of the property_id parcel. Absent with a bare bbox. type: object properties: lat: type: number minimum: -90 maximum: 90 description: Latitude of the reference point. lng: type: number minimum: -180 maximum: 180 description: Longitude of the reference point. required: - lat - lng additionalProperties: false geometry: $ref: '#/components/schemas/MetaGeometry' description: >- The location that ran, defaults filled and keyed as the query is (see MetaGeometry), on REST only: the MCP meta carries reference_point alone. Present on every route that takes a location: the deal lists, summary and cells, the investors, wholesale listings and short-term rental parcels, and `/v1/buyers/match`. Also on the comps of a parcel, kind radius around the subject and property_id the subject, and on POST `/v1/properties/search` (a county-only body echoes nothing). The lender list and a lender's loans carry it when you gave a geometry, a zip or a city. They apply a geometry as the H3 res-8 cells whose centre lies inside it, and echo no county, because MetaGeometry has no county slot. Absent on a route with no location, and on `/v1/properties/resolve`, whose lat + lng is a hint for the nearest parcel, not an area that ran. resolved_from: description: >- Present when an id in the request was an old id from an earlier data refresh: the old ids the API followed, in order. The ids are the investor id, from the path or the investor_id filter, the agent id and the lender id. The lender id comes from the path of the lender routes, the financed_by filter or filters.financing.lender_id. Store the id the response carries, not the old one. type: array items: type: string pattern: ^(inv|agt|len)_[0-9a-f]{12}$ description: >- An investor id (inv_...), a listing agent id (agt_...) or a lender id (len_...). coverage: type: array items: $ref: '#/components/schemas/Coverage' description: >- The markets the response draws on, with their counties, data end dates and data versions. dated: description: >- Present when the response carries a block that is a dated snapshot at its as-of date, not current data. Those blocks are the financing, lien and valuation blocks of the parcel products. One entry per dated block, with its as-of date. Absent when nothing in the response is dated. type: array items: $ref: '#/components/schemas/Dated' terms: type: string description: Attribution and data-use terms for the data in this response. required: - generated_at - coverage - terms additionalProperties: false description: >- Response metadata: when the API produced it, which markets it covers, and how fresh they are. MatchSummary: type: object properties: by_buyer_status: type: object properties: registered: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Deal rows inside the geometry after the filters whose buyer carries an investor id. unclassified: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Rows whose buyer has a name but no investor classification (usually a household). excluded: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Rows whose buyer the registry deliberately left out: custodian trusts, relocation companies, auction houses and ambiguous surnames. unknown: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Rows with no named buyer on the deed. required: - registered - unclassified - excluded - unknown additionalProperties: false description: >- Deal rows inside the geometry after the shared filters, by buyer status. Buyers without an investor id count here too, but the API does not rank them. n_investors_ranked: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Investors with an id that passed the filters and got a score: the total the pages walk. Paged lists carry no total. n_unpriced: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Deal rows inside the geometry with no price on the deed. n_undated: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Deal rows inside the geometry with no purchase date. unregistered: description: >- Only with include_unregistered=true: the id-less buyers inside the geometry, best first, at most 200. Excluded groups need include_excluded=true. type: array items: $ref: '#/components/schemas/UnregisteredBuyer' required: - by_buyer_status - n_investors_ranked - n_unpriced - n_undated additionalProperties: false description: >- Counts for the whole geometry, not only the page, plus the unregistered tail when you ask for it. Problem: type: object properties: type: type: string description: >- URI of the problem: the Errors page of the documentation site, anchored at the code. title: type: string description: Short human-readable summary of the problem code. status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status. code: type: string description: >- Stable machine-readable code from the catalogue at https://developers.investorlift.com/problems.json. detail: type: string description: Human-readable explanation specific to this occurrence. instance: type: string description: Request path. request_id: type: string description: Request id to quote when you report a problem. errors: description: Per-parameter validation failures (400 only). type: array items: type: object properties: param: description: >- The offending parameter. Null when the problem is not about one parameter. type: - string - 'null' message: type: string description: What is wrong with it. code: type: string description: Machine-readable reason, for example invalid_enum_value. required: - param - message - code additionalProperties: false description: One validation failure. required: - type - title - status - code - detail - instance - request_id additionalProperties: {} description: >- RFC 9457 problem details (application/problem+json). Some codes add extra fields beside these: superseded_by, candidates, n_deals, cap, suggestion, markets, retry_after. InvestorListItem: type: object properties: id: type: string pattern: ^inv_[0-9a-f]{12}$ description: Investor id, inv_<12 hex>. List rows always carry an id. market: type: string description: >- Market code, for example phx. The loaded markets are in meta.coverage[]. name: type: string description: >- The deed spelling, the one most often on their deeds, upper case, SURNAME GIVEN for a person, for example "ZAK VENTURES LLC" or "RIVERA DANA". Never a key. Print display_name. display_name: type: string description: >- The name to print. For a cleanly parsed person, it has the form GIVEN [MIDDLE] SURNAME [SUFFIX] in upper case. For example, "DANA RIVERA" from the deed's "RIVERA DANA". For an entity, a trust, a public body, an institutional investor or an ambiguous spelling it equals name. Display only: match, join and search on name. state: type: string description: >- 2-letter state of the market. The loaded markets and their states are in meta.coverage[]. kind: anyOf: - type: string enum: - FLIPPER - WHOLESALER - LANDLORD - BUILDER - IBUYER description: >- 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. - type: 'null' description: >- Primary kind, display only. Filters and scoring read kinds[] instead. Null when id is null. 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. confidence: anyOf: - type: string enum: - STRONG - PROBABLE - WEAK description: >- How sure the registry is of the kind. STRONG: several deals of that kind and a consistent pattern. PROBABLE: some evidence. WEAK: a single signal. The registry judges the confidence from the deeds inside the area loaded for the market (meta.coverage[].universe_kind). In a ZIP market an investor's deals outside the ZIP are unseen, so the confidence is a floor. - type: 'null' description: >- Registry confidence in the primary kind. Null when id is null. How sure the registry is of the kind. STRONG: several deals of that kind and a consistent pattern. PROBABLE: some evidence. WEAK: a single signal. The registry judges the confidence from the deeds inside the area loaded for the market (meta.coverage[].universe_kind). In a ZIP market an investor's deals outside the ZIP are unseen, so the confidence is a floor. scale: anyOf: - type: string enum: - individual - small - mid - large - institutional description: >- 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. - type: 'null' description: >- Scale tier. Null when id is null. 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. institutional: description: >- True for iBuyers, production builders, 500+ holding bulk landlords and the brand list. Lists hide them unless scale includes institutional. Null when id is null. type: - boolean - 'null' is_public: description: >- True for a public body: a county, a city, a housing authority or a school district. Lists hide them unless include_public=true. Null when id is null. type: - boolean - 'null' last_bought_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- Date of their last purchase anywhere inside the area loaded for the market, YYYY-MM-DD. Sales and transfers never count. Null when they never bought or id is null. n_deals: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Investment deals as buyer inside the area loaded for the market (meta.coverage[].universe_kind), all kinds and years, for example 755. The count is a floor in a ZIP market. Null when id is null. buyer_status: type: string enum: - registered - unclassified - excluded - unknown description: >- registered when the row carries an id. Otherwise why the buyer has no id. kinds: type: array items: type: string enum: - FLIPPER - WHOLESALER - LANDLORD - BUILDER - IBUYER description: >- 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. description: >- Every kind the investor qualifies for, for example ["LANDLORD","FLIPPER","BUILDER","WHOLESALER"]. The investor_kind filters and the strategy factor read this list. days_since_last_purchase: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Days between their last purchase and the data end date (meta.coverage[].data_end), for example 7. Null when they never bought. n_purchase_events_12m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Distinct purchase days in the 12 months before the data end date. A bulk same-day buy counts once. n_purchase_events_24m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Distinct purchase days in the 24 months before the data end date. n_flips: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Flips completed inside the area loaded for the market. In a ZIP market the count is a floor. n_wholesales: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Wholesale resales inside the area loaded for the market. A wholesale resale is a resale in under 30 days, or a chain resale or round trip within 90 days. n_holds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Parcels they hold at the deed data end (meta.coverage[].data_end): confirmed holdings plus un-resold purchases. n_long_holds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: 'Parcels held over a year, then resold: landlord exits.' n_bought_from_wholesaler_5y: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Purchases in the 5 years ending on the deed data end (meta.coverage[].data_end) that the deeds document as bought from a wholesaler. The evidence is a double close or a known wholesaler seller. A lower bound: contract assignments leave no deed. price_band: $ref: '#/components/schemas/PriceBand' description: 'What they pay: the quartiles of their priced purchases.' p50_flip_sold_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Median resale price of their flips, whole dollars. Null with fewer than 3 flips. segment_mix: anyOf: - $ref: '#/components/schemas/SegmentMix' - type: 'null' description: >- Shares of their deals by parcel segment. Null when they have no deals. has_person_member: type: boolean description: >- True when a natural person appears among the deed names. A skip trace then has someone to look for. has_home_address: type: boolean description: True when a person member has a non-generic house address on a deed. has_suite_address: type: boolean description: True when a suite or unit address is on file. member_names: type: array items: type: string description: One deed name, raw spelling. description: >- Every deed name that belongs to this investor, entities first. This host omits person names. Raw spelling (SURNAME GIVEN for persons). This list is the input for a name join on the Investorlift side. operator_id: type: string pattern: ^inv_[0-9a-f]{12}$ description: >- Id of the operator this investor belongs to: the investor id with the most purchases among the ids tied together as one buying operation. Shared mailing addresses (deed and tax bill) and shared names tie ids together, often a fresh LLC per deal. The operator id equals id when nothing links this investor, and when the market has no buyer signal. Rows that share an operator_id are one buyer: collapse the others behind the row whose id equals operator_id (the busiest member) and reach them once. The API ranks, pages, counts and scores each id on its own, so an operator with 3 ids can appear 3 times and across pages. The busiest member can change after a data refresh: group by operator_id within one response and store the investor ids, not this id. n_operator_members: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- How many investor ids the operator spans, for example 4: three LLCs and the person behind them. 1 for an investor with no links, and 1 when the market has no buyer signal. auction: anyOf: - $ref: '#/components/schemas/AuctionSummary' - type: 'null' description: >- If, how often and how recently they buy at foreclosure auction and from lenders after a foreclosure, measured to the deed data end (meta.coverage[].data_end). An auction buy is cash within a day, with no inspection. The block carries the counts, the last dates and the two active flags the buys_at_auction and buys_reo filters read. It also carries the share of auction purchases resold within a year. Null where the market publishes no auction counts (meta.coverage[].auction_counted false), zeros where it does and the investor never bought at auction or from a lender. The profile carries the kinds, venues, outcomes and the discount. required: - id - market - name - display_name - state - kind - confidence - scale - institutional - is_public - last_bought_on - n_deals - buyer_status - kinds - days_since_last_purchase - n_purchase_events_12m - n_purchase_events_24m - n_flips - n_wholesales - n_holds - n_long_holds - n_bought_from_wholesaler_5y - price_band - p50_flip_sold_price - segment_mix - has_person_member - has_home_address - has_suite_address - member_names - operator_id - n_operator_members - auction additionalProperties: false description: >- The investor as a list row: who they are and what they do inside the area loaded for the market. InRadius: type: object properties: n_events: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Deal rows of this investor inside the geometry after the filters (every kind). n_purchase_events: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Distinct purchase days inside the geometry: what investor_deals_min counts and the proximity factor scores. n_parcels: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Distinct parcels inside the geometry. n_held_parcels: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Parcels inside the geometry they still own at the deed data end (meta.coverage[].data_end). The API shows this count and does not score it. n_flips: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Flips inside the geometry. n_holds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Holdings and un-resold purchases inside the geometry at the deed data end (meta.coverage[].data_end). n_long_holds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Long holds (held over a year, resold) inside the geometry. volume: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Sum of their bought prices inside the geometry, whole dollars, over priced rows. Null when no row carries a price. last_bought_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- Their last purchase inside the geometry, YYYY-MM-DD. Null when no row is a purchase. last_deal_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- Their last purchase, sale or transfer inside the geometry (display only, never scored). nearest_distance_miles: description: >- Miles from the reference point to their nearest deal here, rounded to 2 decimals. Null without a reference point. type: - number - 'null' median_bought_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Median of what they paid inside the geometry, whole dollars, over priced rows. n_unpriced: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Rows inside the geometry with no price on the deed. n_undated: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Rows inside the geometry with no purchase date. required: - n_events - n_purchase_events - n_parcels - n_held_parcels - n_flips - n_holds - n_long_holds - volume - last_bought_on - last_deal_on - nearest_distance_miles - median_bought_price - n_unpriced - n_undated additionalProperties: false description: >- What this investor did inside the requested geometry, after the shared filters. MatchReason: type: object properties: factor: type: string enum: - proximity - recency - price_fit - strategy - segment - wholesale_buyer - resale_fit - financing description: >- Which factor: proximity scores purchases near the subject, and recency scores how recently and how often they buy, measured to the deed data end. Also, price_fit scores the subject price against their band, strategy their kinds against the subject condition, and segment their deal share in the subject segment. The factor wholesale_buyer scores documented wholesale purchases, and resale_fit scores the subject ARV against their flip resale median, at weight 0 by default. The factor financing shows if the investor borrows from a lender active in the subject parcel's ZIP. Its window is the 24 months ending on the lender registry's slice date (financing.as_of on the profile). It is present with a property_id geometry where the market publishes the registry, at weight 0 always: shown, never scored, in this release. weight: type: number description: >- Effective weight of the factor for this row, 0 to 1, rounded to 4 decimals. The weights of the scored factors sum to 1. The financing weight is always 0 and outside the sum. value: type: number description: >- How well the investor scores on this factor, 0 (poor) to 1 (perfect), rounded to 4 decimals. detail: type: string description: >- One plain sentence that explains the value, for example "9 purchases (12 parcels) within 2 mi, nearest 0.10 mi". required: - factor - weight - value - detail additionalProperties: false description: One scored factor with its weight, value and a sentence for the user. SampleDeal: type: object properties: id: type: string pattern: ^deal_[0-9a-f]{32}$ description: Deal id. It opens `/v1/deals/{id}`. kind: type: string enum: - flip - wholesale - hold - long_hold - other - build description: >- 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. address_short: description: >- Situs street address in title case, for example "7522 E Cholla St". Null when the parcel has no address. type: - string - 'null' latitude: anyOf: - type: number minimum: -90 maximum: 90 description: WGS84 latitude. - type: 'null' description: WGS84 latitude of the parcel. Null when the parcel has no geocode. longitude: anyOf: - type: number minimum: -180 maximum: 180 description: WGS84 longitude. - type: 'null' description: WGS84 longitude of the parcel. Null when the parcel has no geocode. bought_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: Purchase date, YYYY-MM-DD. Null when undated. bought_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Purchase price in whole dollars. Null when the deed records no price: every off-market purchase in a non-disclosure state such as Texas. sold_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- Resale date. Null while the investor holds the parcel at the deed data end. sold_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Resale price in whole dollars. Null while the investor holds the parcel at the deed data end, or when the resale deed carries no price. gross_profit: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Resale price minus purchase price in dollars. Null while the investor holds the parcel at the deed data end, or when either price is unknown. distance_miles: description: >- Miles from the reference point, rounded to 2 decimals. Null when the request had no reference point. type: - number - 'null' bought_from_wholesaler: description: >- True when the investor bought from a wholesaler: a documented double close or a known wholesaler seller. Null when the purchase deed is unknown. type: - boolean - 'null' bought_distressed: description: >- True when the purchase was a distressed sale (foreclosure, trustee, tax). Null when the purchase deed is unknown. type: - boolean - 'null' bought_auction_kind: anyOf: - type: string enum: - TRUSTEE_SALE - SHERIFF_SALE - HOA_TRUSTEE_SALE - TAX_SALE - TAX_LIEN_DEED description: >- 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. - type: 'null' description: >- The kind of auction when the purchase was a third-party auction purchase, for example TRUSTEE_SALE. Null otherwise, and in a market without published auction counts. required: - id - kind - address_short - latitude - longitude - bought_on - bought_price - sold_on - sold_price - gross_profit - distance_miles - bought_from_wholesaler - bought_distressed - bought_auction_kind additionalProperties: false description: >- A trimmed deal used as proof on a buyer row: the nearest deals of that investor inside the geometry. BuyerSignal: type: object properties: operator_id: anyOf: - type: string pattern: ^inv_[0-9a-f]{12}$ description: >- Investor id: inv_ followed by 12 hex characters, for example inv_abaf618f44a3. The id is stable across data refreshes within a market. Store it as the investor's identity. - type: 'null' description: >- Id of the operator this investor belongs to, always set when the block is present. Shared mailing addresses (deed and tax bill) and shared names tie LLCs, trusts and people together as one buying operation. The operator id is the member id with the most purchases, and it equals the investor's own id when no link exists. Rows that share an operator_id are the same buyer: collapse them in a list and reach them once. The id belongs to the busiest member, so it can move to another member after a data refresh: group by it within one response. Do not store it as an identity: store the investor ids. n_operator_members: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- How many investor ids the operator spans, for example 4: three LLCs and the person behind them. 1 for an investor with no links. Always set when the block is present. operator_member_ids: anyOf: - type: array items: type: string pattern: ^inv_[0-9a-f]{12}$ description: One investor id. - type: 'null' description: >- Every investor id of the operator, this one included, sorted. The list carries ids only. Open `/v1/investors/{id}` for each to see its names. Always set when the block is present. is_anchor: description: >- True on the operator_id row itself: the member with the most purchases, the one to show when you collapse the others. Always set when the block is present. type: - boolean - 'null' merge_confidence: anyOf: - type: string enum: - SINGLE - MERGED_STRONG - MERGED_WEAK description: >- How sure the operator link is. SINGLE: one investor id, nothing linked. MERGED_STRONG: a strong sign backs every linked id as the same operation. Such a sign is a shared name token, the ids on one deed together, or two entities at the same address. MERGED_WEAK: only a shared mailing address links the ids, for example a mailbox store. Treat such a collapse with more care. - type: 'null' description: >- Null on a block built without it. How sure the operator link is. SINGLE: one investor id, nothing linked. MERGED_STRONG: a strong sign backs every linked id as the same operation. Such a sign is a shared name token, the ids on one deed together, or two entities at the same address. MERGED_WEAK: only a shared mailing address links the ids, for example a mailbox store. Treat such a collapse with more care. activity_p_180: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- Probability, 0 to 1, that the operator buys at least one house in the 180 days after the data end date, for example 0.36. The registry fitted the model, a cell model with shrinkage to its parent cell, on three years of monthly snapshots. The inputs at each snapshot: the age of the last purchase and the last sale, the depth of the history, the houses held. Null when the operator never bought, or last bought more than 3 years before the data end date. Such dormant operators re-activated at about 3.4% within 180 days in the Phoenix measurement. The w_activity parameter scores a null at that measured rate, and its description gives the number. activity_p_365: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The same probability over the 365 days after the data end date. Null under the same rule as activity_p_180. cell_n: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- How many operator-months the registry fitted the cell behind activity_p_180 on, for example 412. Under 50 the probability leans on its parent cell. Treat it as weak evidence. Null when activity_p_180 is null. activity_model: description: >- Which fitted model produced the probabilities, for example CYCLE_v1. The value changes when the registry refits the model. Null when activity_p_180 is null. type: - string - 'null' cycle_state: anyOf: - type: string enum: - FRESH_CASH - LOADED - STEADY - DORMANT description: >- Where the operator sits in its capital cycle at the data end date, the first of these that applies. FRESH_CASH (cash is back): the operator sold something in the 60 days before the data end date, and a purchase usually follows. For repeat flippers the median next purchase lands 14 days after their own resale. LOADED (capital tied up): 3 or more houses held at the data end date and no resale in the 180 days before it. DORMANT (no purchase in a year): no purchase in the 365 days before data_end and no resale in the 60 days before it. STEADY (none of those): the operator buys and sells without any of those signals. - type: 'null' description: >- Null when the operator never bought. Where the operator sits in its capital cycle at the data end date, the first of these that applies. FRESH_CASH (cash is back): the operator sold something in the 60 days before the data end date, and a purchase usually follows. For repeat flippers the median next purchase lands 14 days after their own resale. LOADED (capital tied up): 3 or more houses held at the data end date and no resale in the 180 days before it. DORMANT (no purchase in a year): no purchase in the 365 days before data_end and no resale in the 60 days before it. STEADY (none of those): the operator buys and sells without any of those signals. capital_freed_60d: description: >- True when the operator sold a house it held in the 60 days before the data end date. Such a sale is a flip resale, a wholesale resale, or the exit of an older holding. Cash is then back, and for repeat flippers the next purchase usually follows within a month. False otherwise. Always set when the block is present. type: - boolean - 'null' days_since_last_purchase: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Days from the operator's last purchase (under any of its ids) to the data end date, for example 21. Can be smaller than the investor's own days_since_last_purchase when a sibling id bought after the investor's own last purchase. Null when the operator never bought. days_since_last_resale: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Days from the operator's last sale of a house it held to the data end date, for example 12. Such a sale is a flip resale, a wholesale resale, or the exit of an older holding. Null when it never sold. open_inventory: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Houses the operator bought and did not resell by the data end date, for example 3. 0 when none. Always set when the block is present. n_purchases_36m: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Purchases by the operator in the 36 months before the data end date, one per house. A bulk buy of 5 houses on one day counts 5. 0 when none. Always set when the block is present. median_gap_days: description: >- Median days between the operator's consecutive purchase days, for example 45. A same-day bulk buy counts once. Null with fewer than 2 purchase days. type: - number - 'null' share_within_30d_of_resale: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of the operator's purchases that closed within 30 days of one of its sales, 0 to 1, for example 0.67. The share counts only purchases made after the operator's first sale. It shows how strongly its buying follows its selling. Null when it has no such purchase: it never sold, or never bought again after its sales. data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The market's data end date, YYYY-MM-DD: the API measures every "days since" value and probability in this block from it. Always set when the block is present. required: - operator_id - n_operator_members - operator_member_ids - is_anchor - merge_confidence - activity_p_180 - activity_p_365 - cell_n - activity_model - cycle_state - capital_freed_60d - days_since_last_purchase - days_since_last_resale - open_inventory - n_purchases_36m - median_gap_days - share_within_30d_of_resale - data_end additionalProperties: false description: >- The buyer signal of an investor: the operator its ids belong to, and where that operator sits in its capital cycle. Also how likely the operator is to buy again in the 180 or 365 days after the data end date. The API measures the block at the data end date. Ids and numbers only, no names. InvestorListings: type: object properties: n_active: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Holdings of this investor listed ACTIVE at listings_data_end whose listing passed the ownership test. 0 when none. n_pending: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Holdings of this investor listed PENDING at listings_data_end whose listing passed the ownership test. 0 when none. n_listed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- n_active + n_pending: what the investor has on the market at listings_data_end. n_listed_undated: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Holdings on the market whose purchase date is unknown, so the ownership test cannot run. The deal rows show them with owner_test UNDATED, and the counts above leave them out. Usually 0. n_holdings_dated: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Hold deal rows of this investor with a purchase date: the holdings the ownership test can run on. n_holdings_undated: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Hold deal rows of this investor without a purchase date. n_holdings_dated + n_holdings_undated is the investor's hold count. median_list_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Median asking price over the counted listings that carry one, whole dollars. Null when the rollup counts nothing, or when no counted listing carries an asking price. min_list_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Lowest asking price among the counted listings that carry one, whole dollars. Null when the rollup counts nothing, or when no counted listing carries an asking price. max_list_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Highest asking price among the counted listings that carry one, whole dollars. Null when the rollup counts nothing, or when no counted listing carries an asking price. With min_list_price the drawer's "asking $289K to $340K". last_listed_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The newest listed_on among the counted listings, YYYY-MM-DD. Null when the rollup counts nothing. n_listed_12m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Listings of this investor's holdings, any status, that went live in the 365 days ending on listings_data_end and passed the ownership test. A lower bound: the feed keeps one listing per parcel, the latest. listings_data_end: type: string description: >- The date the block measures every listing window against, YYYY-MM-DD: the newest status update in the market's listing feed. Later than the deed data_end. required: - n_active - n_pending - n_listed - n_listed_undated - n_holdings_dated - n_holdings_undated - median_list_price - min_list_price - max_list_price - last_listed_on - n_listed_12m - listings_data_end additionalProperties: false description: >- What the investor has on the market at the listing data end date, from the MLS listings on the parcels they hold. Null where it sits when the market has no published listing tables. Zeros when it has them and nothing is listed. InvestorWholesale: type: object properties: 'n': type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Houses the investor bought off an Investorlift listing per a recorded deed, all time. The count takes CONFIRMED rows with the credit on one listing, as distinct closing deeds. 0 when none. n_12m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Of those, closed in the 365 days ending on the deed data_end. n_24m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Of those, closed in the 730 days ending on the deed data_end. n_5y: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Of those, closed in the 5 years ending on the deed data_end. n_probable: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Of the all-time count, the ones matched at MEDIUM or LOW confidence. n minus n_probable is the HIGH-confidence count. last_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The closing date of the investor's newest Investorlift purchase, YYYY-MM-DD. Null when n is 0. n_wholesalers: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Distinct listing companies the investor bought from. top_wholesalers: type: array items: $ref: '#/components/schemas/TopWholesaler' description: >- The companies the investor bought from most, most first, at most 3. Empty when n is 0. n_double_closed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Of the all-time count, the ones closed through a double close. median_asking_price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: >- Median asking price of the listings the investor bought, whole dollars. Null when no listing carried a price. data_end: type: string description: >- The deed data end date, YYYY-MM-DD, the same as meta.coverage[].data_end. The API measures the windows against it. The Investorlift export date is meta.coverage[].wholesale_as_of. required: - 'n' - n_12m - n_24m - n_5y - n_probable - last_on - n_wholesalers - top_wholesalers - n_double_closed - median_asking_price - data_end additionalProperties: false description: >- What the investor bought off Investorlift listings, per the recorded deeds: counts by window, the last one, and the companies they buy from. Null where it sits when the market has no published wholesale tables. Zeros when it has them and the investor never bought one. InvestorStr: type: object properties: n_holdings: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Holdings of this investor whose parcel carries a business-use short-term-rental licence attributed to them, for example 3. A licensed 116-unit building is one holding. 0 when none. n_permits: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Attributed active licence numbers across those holdings, for example 3. A building counts every unit here. n_at_purchase: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Of the holdings, the ones licensed within 180 days of the purchase: bought to be a short-term rental. n_assumed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Of the holdings, the ones attributed on basis ASSUMED: no date, no name, no regime bound. n_owner_occupied_licences: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Parcels the investor's own people live in that carry a licence, for example a casita permit on a home. n_holdings does not count them. The block counts them here so the operator's whole footprint is visible. n_managed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Of the holdings, the ones whose record names a property-management company (short_term_rental.manager). share: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- n_holdings divided by the investor's holds inside the loaded area (n_holds), 4 decimals, for example 0.5. A share of 0.5 means half of what they hold is a licensed short-term rental. Null when n_holds is 0. manager_companies: type: array items: type: string description: One company name as the city writes it. description: >- The property-management companies named across the holdings, for example ["VACASA LLC"]. Empty when no record names one. Company names only, served to every key. jurisdictions: type: array items: type: string description: One jurisdiction, upper case. description: >- The cities the holdings fall in, for example ["SCOTTSDALE", "PHOENIX"]. Empty when n_holdings is 0. stale_jurisdictions: type: array items: type: string description: One jurisdiction, upper case. description: >- Of those cities, the ones whose feed is stale this week. For them the API serves the last good snapshot, and the failed week does not change the counts here. Empty when none. last_application_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The newest application or issue date across the holdings, YYYY-MM-DD. Null when no holding carries one, as for every Houston holding. required: - n_holdings - n_permits - n_at_purchase - n_assumed - n_owner_occupied_licences - n_managed - share - manager_companies - jurisdictions - stale_jurisdictions - last_application_on additionalProperties: false description: >- How much of the investor's portfolio is licensed for short-term rental, from the cities' own rolls. The block counts holdings, not permits, and only where the API attributes the licence to the investor and the use is a business. Null where it sits when the market has no published short-term rental tables. Zeros when it has them and the investor holds no such parcel. MetaGeometry: type: object properties: kind: type: string enum: - radius - bbox - place description: >- Which location ran: radius, bbox or place. A radius is a point with radius_miles, or a property_id request, which runs around the parcel centroid. A bbox is a viewport. A place is a ZIP list or a postal city. lat: anyOf: - type: number minimum: -90 maximum: 90 description: WGS84 latitude. - type: 'null' description: >- The centre of the radius, or the reference point you gave beside a bbox or a place. For a property_id request the centre is the parcel centroid. Null when a bbox or a place had no reference point. lng: anyOf: - type: number minimum: -180 maximum: 180 description: WGS84 longitude. - type: 'null' description: The longitude beside lat. Null when lat is null. radius_miles: description: >- The radius that ran, in miles: the value you sent, or the default when you sent none. The default is 2 on the GET lists and 1 around property_id on POST `/v1/properties/search`. Null for a bbox or a place. type: - number - 'null' bbox: anyOf: - type: array prefixItems: - type: number minimum: -180 maximum: 180 description: West edge (longitude). - type: number minimum: -90 maximum: 90 description: South edge (latitude). - type: number minimum: -180 maximum: 180 description: East edge (longitude). - type: number minimum: -90 maximum: 90 description: North edge (latitude). items: false minItems: 4 maxItems: 4 description: '[west, south, east, north] in WGS84 degrees.' - type: 'null' description: >- The viewport as [west, south, east, north] in WGS84 degrees. Null unless kind is bbox. property_id: anyOf: - type: string pattern: ^prop_[0-9a-f]{32}$ description: >- Parcel id: prop_ followed by 32 hex characters, for example prop_e93c776c53354a88de4e58448a6bf21b. The prefix is part of the id. - type: 'null' description: >- The parcel at the centre of the radius. Null unless the request named property_id. zip: anyOf: - type: array items: type: string pattern: ^\d{5}$ - type: 'null' description: >- The ZIP list as you sent it, for example ["85251", "85257"]. Null unless kind is place and the request named ZIPs. city: description: >- The postal city as the API compared it: trimmed and folded to upper case ("Scottsdale" ran as "SCOTTSDALE"). Null unless kind is place and the request named a city. type: - string - 'null' required: - kind - lat - lng - radius_miles - bbox - property_id - zip - city additionalProperties: false description: >- The location the API computed the response over, as it ran: defaults filled, a parcel resolved to its centroid, a city folded. Copy it back as the query to repeat the request. Coverage: type: object properties: market: type: string description: Market code, for example phx. One entry per loaded market. state: type: string description: >- 2-letter state of the market. The loaded markets and their states are in meta.coverage[]. counties: type: array items: type: object properties: fips: type: string description: The 5-digit county FIPS code, for example 04013. name: type: string description: County name, for example Maricopa. data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The last deed date on file for this county, YYYY-MM-DD. Null when the county carries no dated deed. required: - fips - name - data_end additionalProperties: false description: One county the loaded area lies in. description: >- The counties the loaded area lies in, each with its own data end date. For a zip market the list names the county, but the loaded area is only the ZIP (see universe_kind). bbox: type: array prefixItems: - type: number minimum: -180 maximum: 180 description: West edge (longitude). - type: number minimum: -90 maximum: 90 description: South edge (latitude). - type: number minimum: -180 maximum: 180 description: East edge (longitude). - type: number minimum: -90 maximum: 90 description: North edge (latitude). items: false minItems: 4 maxItems: 4 description: >- The rectangle (west, south, east, north) that encloses every deal in the market: the initial map viewport and, with point_tolerance_miles, the limit for outside_coverage. data_end: type: string description: >- The last deed date in the data, YYYY-MM-DD. The API measures every "days since" value from this data_end, never from the request time. build_run_id: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Which pipeline build produced the data. Informational: use dataset_version for caching. Null when the data does not record it. registry_run: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Which investor registry run produced the data. Informational: use dataset_version for caching. Null when the data does not record it. registry_version: description: >- Which registry code version produced the data. Informational: use dataset_version for caching. Null when the data does not record it. type: - string - 'null' dataset_version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Version of the loaded data, an integer that grows with every refresh. It is the cache key and the ETag, and every cursor binds to it. loaded_at: type: string description: When this data version went live, ISO 8601. metro_buy_to_resale_ratio: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The median of purchase price divided by resale price over the market's priced flips since 2021. For example, 0.72 means flippers pay about 72% of the resale price. The price_fit factor uses it when an investor has too few flips of their own. Null when no priced flips exist. universe_kind: anyOf: - type: string enum: - zip - county - metro description: >- The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. - type: 'null' description: >- Null when the market row does not record it, a seed older than the column. The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. universe_zips: anyOf: - type: array items: type: string description: A 5-digit ZIP. - type: 'null' description: >- The ZIP codes of a zip universe, for example ["77088"]. Null for county and metro markets. point_tolerance_miles: type: number description: >- How far outside bbox a point can lie and get an answer, in miles: 20 for a metro, 2 for a county market. The point is lat + lng, or the centre of a property_id parcel. Farther out, the API answers 422 outside_coverage. A bbox must intersect the coverage bbox. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels in the loaded area, the universe every count covers. Null when the data does not record it. listings_data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The as-of date of the MLS listing feed for this market, YYYY-MM-DD: the newest status update among its listing rows, later than data_end. The deeds and the listings arrive in one delivery, each with its own end. The API measures every listing window (days_on_market, n_listed_12m) against this date. Null when this market has no published listing tables. Every listing block and listings rollup is null then, and the correct reading is "no listing data". agents_data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The as-of date of the listing set behind the agent registry of this market, YYYY-MM-DD. It equals listings_data_end when the registry is current. It is earlier when a refresh moved the listings but left the agents on the older set. Null when this market has no published agent tables. Then every agent_id, identity_basis and agent_is_holder_member on the listing agents is null, and the investor profile carries has_licensed_member and agent_links null. The /v1/agents routes then answer 422 agents_unavailable. wholesale_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the Investorlift export behind the market's wholesale transactions, YYYY-MM-DD. Every Investorlift listing published up to this date is on file. The API measures every wholesale window (n_listed_12m, n_bought_via_investorlift_12m) against the deed data_end. Null when this market has no published wholesale tables. Then every wholesale_listing block on deal rows, wholesale_purchases block on investor rows and wholesale_listings[] on a parcel is null. Then /v1/wholesale-listings, /v1/wholesalers, `/v1/investors/{id}/wholesale-purchases` and the source=investorlift and bought_on_investorlift filters answer 422 wholesale_unavailable. str_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The short-term rental snapshot of this market, YYYY-MM-DD: the oldest snapshot date among its served jurisdictions. Each jurisdiction's own date is in str.jurisdictions[].snapshot_date and on every block as data_as_of. Null when this market has no published short-term rental tables, or when the API serves none of its jurisdictions. Then every short_term_rental block on parcels and hold rows and every str roll-up on investor rows is null. Then the str_status, str_business_use, str_operator and str_holdings_min filters and /v1/str-parcels answer 422 str_unavailable. str: anyOf: - type: object properties: jurisdictions: type: array items: $ref: '#/components/schemas/StrCoverageJurisdiction' description: >- Every city of the market the short-term rental build knows, served or not. This list, not the parcel, explains a null block on a parcel: read the city's coverage_reason. required: - jurisdictions additionalProperties: false - type: 'null' description: >- The short-term rental jurisdiction table of this market. Null when this market has no published short-term rental tables. auction_counted: type: boolean description: >- True when this market measures the foreclosure-auction and REO purchase counts. Then every investor row carries the auction block (investor.auction) and deal rows carry bought_auction_kind. False when the market's registry build came before the counts existed. Then the block is null on every investor of the market, and bought_auction_kind is null on every deal. The buys_at_auction, buys_reo and bought_auction_kind filters then answer 422 auction_unavailable. parcel_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The deed data end that the build of the parcel product layer used, YYYY-MM-DD. The layer serves POST /v1/properties/search and the financing, permit and history routes. Null when this market has no published parcel product tables: those routes then answer 422 parcels_unavailable. address_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The deed data end of the address table behind GET /v1/properties/resolve?address, YYYY-MM-DD. Null when this market has no published address table. The address lookup answers 422 addresses_unavailable while no market carries the table. parcel: anyOf: - $ref: '#/components/schemas/ParcelCoverage' - type: 'null' description: >- What the parcel products cover in this market. The parts are the layer, the dated financing slice, the permit snapshot, the Owner Profile block and the history lake with its ZIP set. Null when this market has no published parcel product tables. lenders: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The slice date behind the lender registry, YYYY-MM-DD. It equals parcel.financing.as_of. recordings_through: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The newest recording date in either source table, YYYY-MM-DD. The API measures every recency on a lender against this date. counties: type: array items: type: string description: A 5-digit county FIPS. description: >- The counties the lender registry covers. A ZIP, city or county outside them answers 422 outside_coverage. history_capture_share: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of open lien positions recorded since 2022 that the recorded history also carries within 3 days, 0 to 1. It says how much of the open table the history sees. n_lender_ids: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Lender ids served in the market: the identities with a profile, after the person gate. parcel.financing.n_lenders counts raw spellings, several per id. purchase_measured: type: boolean description: >- True when the market has the deed link. Then the API serves purpose and the deed block on the loan rows, and the purchase-money counts and ranks on the lenders. It also serves the lender list's purpose, investor_only and purchase_desc parameters. False on a registry built before the deed link: every such value is null, and those parameters answer 422 lenders_unavailable. investor_lending_measured: type: boolean description: >- True when the market has the deal link and the borrower match. Then the API serves the deal block, outcome and investor ids on the loan rows, and the investor_lending block on the profiles. It also serves the financing block on deal rows and the financing sidecar on investor profiles. False otherwise: every one of those is null. flips_measured: type: boolean description: >- True when the market measures the flips each lender financed, the flips_financed block on the profiles. False otherwise: the block is null. borrowers_measured: type: boolean description: >- True when the market has the borrower fold. Then the API serves borrower keys on the loan rows, the borrowers block on the profiles, GET `/v1/lenders/{id}/borrowers` and the financed_by and uses_private_lender filters. False otherwise: the block is null, and the route and the filters answer 422 lenders_unavailable. takebacks_measured: type: boolean description: >- True when the registry of this market includes the foreclosure take-backs. That needs the auction deed tables built and the lender members present. Then the API serves the takebacks block on the profiles, the foreclosed block on the loan rows and the FORECLOSED outcome. False otherwise: the block is null on every profile, and foreclosed is null on every loan row. counties_measured: type: boolean description: >- True when the market has more than one loaded county, so a county ranking means something: rankings.n_counties_ranked_first_24m on the profiles. False while the slice covers one county: that count is null. dated: description: >- True when the registry is a snapshot valued at as_of, like the financing slice behind it. The API stamps every value from it in meta.dated[] as the lenders block. Null on a registry row that does not record it, a row older than the column. type: - boolean - 'null' n_parcels_uncovered: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels of the market outside the counties the registry covers. Such a county is one the financing slice does not reach. Null when the row does not record it. required: - as_of - recordings_through - counties - history_capture_share - n_lender_ids - purchase_measured - investor_lending_measured - flips_measured - borrowers_measured - takebacks_measured - counties_measured - dated - n_parcels_uncovered additionalProperties: false - type: 'null' description: >- The lender registry of this market. Null when this market has no published lender tables: every /v1/lenders route then answers 422 lenders_unavailable. required: - market - state - counties - bbox - data_end - build_run_id - registry_run - registry_version - dataset_version - loaded_at - metro_buy_to_resale_ratio - universe_kind - universe_zips - point_tolerance_miles - n_parcels - listings_data_end - agents_data_end - wholesale_as_of - str_as_of - str - auction_counted - parcel_as_of - address_as_of - parcel - lenders additionalProperties: false description: >- One loaded market: the area its counts cover (universe_kind), the counties it lies in, how fresh it is, and its data version. Dated: type: object properties: block: type: string enum: - valuation - financing - liens - lenders description: >- The block of the response that is a snapshot at as_of, not current data. The values are valuation (the AVM, equity and LTV), financing (open liens and mortgage history), liens (involuntary liens) and lenders. The lenders block is the lender registry and every count on it, built from the same slice. as_of: type: string description: >- The date of the delivery that valued the snapshot, YYYY-MM-DD: the same date as meta.coverage[].parcel.financing.as_of for the market. reason: type: string description: >- Why the block is dated, in one sentence: the dataset is not in the current delivery. required: - block - as_of - reason additionalProperties: false description: >- One block of the response that is a dated snapshot. Every response that carries a value from a dated block lists it here. A caller that cannot use dated data passes require_current: true. The API then answers 422 dated_refused instead. UnregisteredBuyer: type: object properties: state: description: >- 2-letter state of the mailing address of the buyer, when known. Null otherwise. type: - string - 'null' n_events: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Their deal rows inside the geometry after the filters (usually 1). last_bought_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- Their last purchase inside the geometry, YYYY-MM-DD. Null when none was a purchase. nearest_distance_miles: description: >- Miles from the reference point to their nearest deal here, rounded to 2 decimals. Null without a reference point. type: - number - 'null' buyer_status: type: string enum: - registered - unclassified - excluded - unknown description: >- Here only unclassified, a named buyer that is not an investor, or excluded with include_excluded=true. 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. buyer_exclusion: anyOf: - type: string enum: - INSTITUTION - AMBIGUOUS_NAME - POOLED_NAME description: >- Why an excluded buyer has no investor id. INSTITUTION: a custodian, a relocation company or an auction house. AMBIGUOUS_NAME: a bare surname. POOLED_NAME: a name that many unrelated people share. - type: 'null' description: >- Null for unclassified buyers. Why an excluded buyer has no investor id. INSTITUTION: a custodian, a relocation company or an auction house. AMBIGUOUS_NAME: a bare surname. POOLED_NAME: a name that many unrelated people share. score: type: number description: >- Proximity and recency only, best first, rounded to 4 decimals. The scale is 0 to 1, the same as data[].base_score with the other weights set to 0. The weight w_activity does not apply to the unregistered tail: nothing here has a buyer signal. required: - state - n_events - last_bought_on - nearest_distance_miles - buyer_status - buyer_exclusion - score description: >- An id-less buyer inside the geometry: a household or an unclassified name that bought here. A lead, not a ranked investor. PriceBand: type: object properties: window: anyOf: - type: string enum: - 5y - all - type: 'null' description: >- Which purchases the band covers. The value 5y is the priced purchases in the 5 years before the data end date. The value all is every priced purchase, all time. The band uses all when fewer than 5 priced purchases fall in those 5 years. Null when no priced purchase exists. p25: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: 25th percentile of what they paid, whole dollars. p50: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: Median of what they paid, whole dollars, for example 250000. p75: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Whole US dollars. - type: 'null' description: 75th percentile of what they paid, whole dollars. n_priced_purchases: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Priced purchases behind the band. The band ignores a price under $20,000 as nominal. With 1 or 2 the band is a single point. Treat it as weak evidence. required: - window - p25 - p50 - p75 - n_priced_purchases additionalProperties: false description: 'What the investor pays: the quartiles of their priced purchases.' SegmentMix: type: object properties: sfr: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: Share of their deals on single-family houses, 0 to 1. condo_th: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: Share on condos and townhouses, 0 to 1. other: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- Share on everything else (manufactured, multi-family, land, commercial), 0 to 1. OTHER is a mixed bucket. required: - sfr - condo_th - other additionalProperties: false description: Shares of the investor's deals by parcel segment. The three add up to 1. AuctionSummary: type: object properties: n_auction_buys: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Houses bought at a foreclosure auction inside the area loaded for the market, all time. The count is of distinct parcels bought at a TRUSTEE_SALE or SHERIFF_SALE by a third party. A lender that bids its own loan, a trustee and a bulk instrument never count. For example 12. The related n_distressed_buys on the profile counts deals whose purchase deed was any distressed instrument, deeds in lieu and feed-flagged REO included. n_auction_buys_24m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- The same over the 24 months before the data end date: what is_active_auction_buyer and the buys_at_auction filter read. last_auction_buy_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of their last auction purchase, YYYY-MM-DD: the sale day, when the buyer paid the cash. Null when they never bought at auction. The feed records a trustee's deed a median 1 day (Phoenix) to 7 days (Harris) after the sale. The 90th percentile in Harris is 23 days, so the newest purchases can be a few weeks behind. is_active_auction_buyer: type: boolean description: >- True when n_auction_buys_24m is at least 1: a cash buyer who bought without an inspection in the 24 months before the data end date. Within that window the measured lift over other buyers held. The buys_at_auction filter reads this flag. auction_resale_share: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of their auction purchases resold within 12 months to a third party, 0 to 1, for example 0.7 (7 of 10 flipped). The share counts only purchases made at least 12 months before the data end date. For the rest, the buyer held them through those 12 months, transferred them to its own next name, or lost them to a senior lender. Null under 3 such purchases. n_reo_buys: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Houses bought from a lender, servicer or agency after a foreclosure, all time since 2012, inside the area loaded for the market. Such a purchase is a bank-owned (REO) sale: the deed after the take-back, sold by an institution to a third party. For example 3. A weaker cash signal: the buyer had weeks and an inspection, and a loan is possible. n_reo_buys_24m: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- The same over the 24 months before the data end date: what is_active_reo_buyer and the buys_reo filter read. last_reo_buy_on: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of their last REO purchase, YYYY-MM-DD. Null when they never bought REO. is_active_reo_buyer: type: boolean description: True when n_reo_buys_24m is at least 1. The buys_reo filter. required: - n_auction_buys - n_auction_buys_24m - last_auction_buy_on - is_active_auction_buyer - auction_resale_share - n_reo_buys - n_reo_buys_24m - last_reo_buy_on - is_active_reo_buyer additionalProperties: false description: >- The investor's purchases at foreclosure auction and from lenders after a foreclosure (REO): if it buys there, how often, and when last. Auction buyers pay cash within a day and buy without seeing the inside, and a trustee sale is final at the sale. Sheriff, HOA and tax sales are cash too, but they carry a redemption period and, for HOA sales, the first mortgage. So the profile shows them as separate kinds. Null where the market publishes no auction counts (meta.coverage[].auction_counted false). Zeros when it publishes them and the investor never bought that way. TopWholesaler: type: object properties: id: type: string pattern: ^wsr_[0-9a-f]{12}$ description: >- Wholesaler id (an Investorlift listing company): wsr_ followed by 12 hex characters, for example wsr_3f9a1c27b4e0. The id is stable per company across data refreshes. It is the key to GET `/v1/wholesalers/{id}`. The prefix is part of the id. name: type: string description: The company's name as it appears on Investorlift. 'n': type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- How many of the investor's Investorlift purchases this company listed. required: - id - name - 'n' additionalProperties: false description: One of the companies this investor buys from most on Investorlift. StrCoverageJurisdiction: type: object properties: name: type: string description: >- The jurisdiction, upper case, for example SCOTTSDALE, PHOENIX or HOUSTON: the city-limit polygon the parcel falls in, never the postal city. The same value as short_term_rental.coverage.jurisdiction on the parcels inside it. regime: anyOf: - type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN description: >- The city's rule on a short-term rental licence or permit. REQUIRED: an ordinance requires one. NOT_REQUIRED: the city has no requirement, so no roll exists. UNKNOWN: the survey did not cover the city. Null when the market row does not record it. - type: 'null' description: >- Null when the market row does not record it. The city's rule on a short-term rental licence or permit. REQUIRED: an ordinance requires one. NOT_REQUIRED: the city has no requirement, so no roll exists. UNKNOWN: the survey did not cover the city. Null when the market row does not record it. coverage_reason: anyOf: - type: string enum: - LOADED_SERVED - LOADED_UNVALIDATED - LOADED_COUNTS_ONLY - REQUIRED_NOT_PUBLISHED - NO_REQUIREMENT - NOT_SURVEYED description: >- Why parcels of this jurisdiction carry, or do not carry, a short-term rental block. LOADED_SERVED: the city's roll is on file, matched to parcels and served, so every parcel inside carries a block, NONE when it has no record. LOADED_UNVALIDATED: the roll is on file and matched, but without a spot check, so the block is present with status null and coverage.served false. LOADED_COUNTS_ONLY: the roll is on file for counts only, because no parcel match is possible for the file, so no block. No block for REQUIRED_NOT_PUBLISHED (licence required, no roll published), NO_REQUIREMENT (no licence required) or NOT_SURVEYED (outside the survey). Null when the market row does not record it. - type: 'null' description: >- Null when the market row does not record it. Why parcels of this jurisdiction carry, or do not carry, a short-term rental block. LOADED_SERVED: the city's roll is on file, matched to parcels and served, so every parcel inside carries a block, NONE when it has no record. LOADED_UNVALIDATED: the roll is on file and matched, but without a spot check, so the block is present with status null and coverage.served false. LOADED_COUNTS_ONLY: the roll is on file for counts only, because no parcel match is possible for the file, so no block. No block for REQUIRED_NOT_PUBLISHED (licence required, no roll published), NO_REQUIREMENT (no licence required) or NOT_SURVEYED (outside the survey). Null when the market row does not record it. served: type: boolean description: >- True when parcels inside this jurisdiction carry a measured status (LICENSED, PENDING, EXPIRED or NONE). False when they carry a block with status null, or no block at all: coverage_reason says why. snapshot_only: type: boolean description: >- True when the roll came from a single pull and has no weekly feed (Fountain Hills, Cave Creek). Its dates are the pull date, and the API never sets feed_stale. licence_start: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The earliest possible date of a licence in this jurisdiction, the day its ordinance took effect, YYYY-MM-DD, for example 2025-10-01 for Houston. Null when unknown, or when the city requires no licence. snapshot_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The snapshot the served blocks read, YYYY-MM-DD: short_term_rental.data_as_of on every parcel inside. Null when no roll is on file. feed_stale: type: boolean description: >- True when this week's feed failed the freshness rule and the API serves the last good snapshot instead. Every block inside then carries coverage.feed_stale true. False otherwise. sources: type: array items: $ref: '#/components/schemas/StrCoverageSource' description: >- The city files behind this jurisdiction, each with its newest load date and its stale flag. Empty when no roll is on file. n_licensed: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels inside with status LICENSED on this snapshot. Null when no roll is on file. n_pending: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels inside with status PENDING. Null when no roll is on file. n_expired: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels inside with status EXPIRED. Null when no roll is on file. n_advertised: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels the city lists as advertised without a licence, Scottsdale only. The API counts them and never serves them as a status. Null when the city publishes no such list. share_unmatched: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of the city's records that matched no parcel, 0 to 1, for example 0.04. Null when no roll is on file. share_assumed: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of attributed parcels with attribution_basis ASSUMED, 0 to 1. ASSUMED means the attribution has no date, no name and no regime bound. Null when no roll is on file. required: - name - regime - coverage_reason - served - snapshot_only - licence_start - snapshot_date - feed_stale - sources - n_licensed - n_pending - n_expired - n_advertised - share_unmatched - share_assumed additionalProperties: false description: >- One city of the market in the short-term rental build. It says if the licence roll is on file and served, how fresh it is, and what it counts. It explains a null short_term_rental block on a parcel: the block is null where the API does not serve the jurisdiction. ParcelCoverage: type: object properties: parcel_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: The deed data end that the parcel layer build used, YYYY-MM-DD. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels in the layer for this market. sale_mortgage_measured: type: boolean description: >- True when the delivery records a purchase mortgage on at least one priced last sale in five of the market. Then cash_sale_proxy, the sale.cash_sale filter and the cash-buyer quicklist are measured. False below that bar, as in the 2026 deliveries, which carry the column empty. Then cash_sale_proxy is null on every parcel, and the filter and the quicklist answer 422 cash_sale_unavailable. financing: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the delivery that valued the financing, lien and valuation slice, YYYY-MM-DD. dated: type: boolean description: >- True while the Recorder & Mortgage and AVM datasets are not in the current delivery, so the slice stays at as_of. The API then stamps every value from the slice in meta.dated[]. dated_reason: description: Why the slice is dated. type: - string - 'null' n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with a row in the slice. n_with_open_lien: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with at least one open lien at as_of. n_free_and_clear: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with zero open liens at as_of. n_avm: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with an AVM at as_of. n_involuntary: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with an involuntary lien at as_of. n_lenders: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Distinct raw lender spellings over the two lien tables, not registry ids. For registry ids, read meta.coverage[].lenders.n_lender_ids. required: - as_of - dated - dated_reason - n_parcels - n_with_open_lien - n_free_and_clear - n_avm - n_involuntary - n_lenders additionalProperties: false - type: 'null' description: The financing slice. Null when this market has none. permits: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The effective date of the loaded permit snapshot, YYYY-MM-DD. n_permits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Permits served for this market. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with at least one permit. n_unmatched: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Permits in the county file that landed on no parcel of the market, so the API does not serve them. jurisdictions: anyOf: - type: array items: type: object properties: jurisdiction: type: - string - 'null' n_permits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' last_issue_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' windows_measured: description: >- True when the jurisdiction issued a permit in the 12 months before as_of. False when it did not: its feed is stale, so its parcels carry null 24-month and 36-month windows. The rule applies in every market. Read those null windows (n_permits_24m, n_open_permits_12m, major_work_36m, tags_24m, job_value_24m) as unmeasured, not as permit-free. The negative permit filters of the search leave such parcels out. Null only on a coverage row built before the flag existed. type: - boolean - 'null' required: - jurisdiction - n_permits - last_issue_date - windows_measured additionalProperties: false - type: 'null' description: >- The issuing jurisdictions, largest first, each with its permit count, its newest issue date and its windows_measured flag. required: - as_of - n_permits - n_parcels - n_unmatched - jurisdictions additionalProperties: false - type: 'null' description: The permit snapshot. Null when this market has none. owner_profile: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the delivery the Owner Profile block comes from, YYYY-MM-DD. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels carrying a profile. n_multi: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels whose owner holds two or more properties. n_portfolio_5: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels whose owner holds five or more. required: - as_of - n_parcels - n_multi - n_portfolio_5 additionalProperties: false - type: 'null' description: The Owner Profile block. Null when this market has none. history: anyOf: - type: object properties: first_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The first weekly file the history lake replayed (the baseline FULL). last_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: The last weekly file replayed. zips: anyOf: - type: array items: type: string - type: 'null' description: >- The ZIP codes the history lake covers. A parcel outside them has no history: `GET /v1/properties/{id}/history` answers 422 history_unavailable and the history block is null. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels observed in the ZIP set. n_events: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Typed events on record. n_weeks: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Weekly files replayed. domains: anyOf: - type: object propertyNames: type: string additionalProperties: type: object properties: first_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' last_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' n_events: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - first_week - last_week - n_events additionalProperties: false - type: 'null' description: >- Per domain, the weeks the lake covers it. Valuation and financing end at the financing slice date, financing.as_of. The rest run to last_week. required: - first_week - last_week - zips - n_parcels - n_events - n_weeks - domains additionalProperties: false - type: 'null' description: The history lake. Null when this market has none. required: - parcel_as_of - n_parcels - sale_mortgage_measured - financing - permits - owner_profile - history additionalProperties: false description: >- What the parcel products cover in one market. The parts are the parcel layer, the dated financing slice, the permit snapshot, the Owner Profile block and the history lake. Each carries its as-of date and counts. StrCoverageSource: type: object properties: source: type: string description: >- The source code of one city file, for example S1 (the Scottsdale licensed roll), P1 (the Phoenix active permits layer) or COH (the Houston registry). snapshot_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the newest load of this source, YYYY-MM-DD. Null before the first load of this source. stale: type: boolean description: >- True when the newest load failed the freshness rule and the API still serves the previous snapshot. A load fails the rule when the count moved more than 30 percent, or when its newest date is more than 14 days old. required: - source - snapshot_date - stale additionalProperties: false description: >- One city file behind a jurisdiction's short-term rental data: the date of its newest load, and if that load is stale. headers: ETag: description: >- The entity tag of the answer, derived from the dataset version of the markets in the response and from the representation, not from the body. It moves only when a refresh rebuilds the tables of a market. On a JSON route, send it back as If-None-Match, and an unchanged dataset answers 304 with no body. The API streams an export whatever the tag. GET /v1/dataset runs no query, so it is the lowest-cost place to send the tag. On every 2xx and the 304, never on an error. schema: type: string X-Request-Id: description: >- The id of this call. The edge mints it and also sends it as zp-rid, the gateway's own name for it. The API keys its log line for the call on it, and every error body repeats it as request_id. Log it on every response, not only on errors. A refusal the gateway answers itself carries zp-rid and request_id alone. Those refusals are a 401, a 403 quota_exceeded and a 429 at the limit of the plan. schema: type: string X-Rows: description: >- How many rows the body carries: data.length on a list, 1 on a single record. The size of the body, not a charge. Absent on a streamed export, whose count the API knows only when the stream ends, and on a 304. schema: type: integer minimum: 0 X-Dataset-Version: description: >- The dataset version of every market in the response, as market=version pairs joined by commas (phx=1788469819 for one market). The header carries one pair per loaded market. The figures are the same as meta.coverage[].dataset_version, and you can read them without parsing the body. A version moves only when a refresh rebuilds the tables of the market, so fold the label into cache keys. On every 2xx and the 304, never on an error. Absent when the answer names no market: an empty deployment, or a GET /v1/coverage lookup outside every market. schema: type: string X-Data-End: description: >- The last deed date of every market in the response, as market=YYYY-MM-DD pairs joined by commas (phx=2026-08-12 for one market). The header carries one pair per loaded market. The dates are the same as meta.coverage[].data_end. On every 2xx and the 304, never on an error. Absent when the answer names no market: an empty deployment, or a GET /v1/coverage lookup outside every market. schema: type: string X-Credits-Charged: description: >- The origin sets this header: the credits this response cost. It is 0 when the account already unlocked every record on it. The plans page of the documentation site says what counts. schema: type: integer minimum: 0 X-Credits-Remaining: description: >- The edge sets this header: the credits left in the billing period after this response, recent to within a minute. It is negative on a plan with overage, down to its ceiling. Absent on Enterprise. schema: type: integer Retry-After: description: >- Whole seconds to wait before you retry, never below 1. On a 429, the seconds until the spent bucket refills. On a 503, 1 for pool_saturated and 5 for ledger_unavailable, and none for database_unavailable. On a 403 plan_limit for the name-search day cap, the seconds to the next UTC midnight, when the cap resets. The other plan limits carry none. The body repeats it as retry_after on the 429, the ledger refusal and the day cap. schema: type: integer minimum: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key. ```` ## Related topics - [Rank nearby investors as buyers for a property](/api-reference/buyers/rank-nearby-investors-as-buyers-for-a-property.md) - [List investors in an area](/api-reference/endpoints/investors-list.md) - [Top buyers in a place](/guides/walkthroughs/top-buyers.md) - [Errors](/guides/concepts/errors.md) - [List the investors active inside an area](/api-reference/investors/list-the-investors-active-inside-an-area.md)