{
"id": "<string>",
"market": "<string>",
"name": "<string>",
"brands": [
"<string>"
],
"entity_names": {
"own": [
"<string>"
],
"partner": [
"<string>"
]
},
"home_state": "<string>",
"investor_id": "<string>",
"source_account_id": 0,
"n_listings": 0,
"n_verified": 0,
"n_to_investors": 0,
"n_double_closed": 0,
"n_took_title": 0,
"n_retail": 0,
"n_open": 0,
"n_no_transfer": 0,
"n_none": 0,
"n_shared": 0,
"first_listed_on": "<string>",
"last_listed_on": "<string>",
"n_listed_12m": 0,
"median_asking_price": 0,
"median_days_to_deed": 123,
"top_buyers": [
{
"investor_id": "<string>",
"name": "<string>",
"display_name": "<string>",
"n_deals": 0,
"last_bought_on": "<string>",
"n": 0
}
],
"data_end": "<string>"
}The Wholesaler object
An Investorlift listing company: what it listed, how fast it closes, and who buys from it.
wsr_ plus 12 hex characters. It is a business, so
the API always names it, on every key: its name, its brand, and the entity names it lists under.
The profile answers three questions a user asks about a company before a deal with it:
- Do their listings actually close? The verified transaction counts by verdict, against everything they listed.
- How fast? The typical days from publication to a recorded deed.
- Who buys from them?
top_buyers[], the registry investors who take the most of their listings. Each carries itsname(the deed spelling) and, since 0.31.0, itsdisplay_nameto print.
| Endpoint | What it gives you |
|---|---|
GET /v1/wholesalers/search | The company id, from a name, a brand or an entity name. |
GET /v1/wholesalers/{id} | The profile below. |
GET /v1/wholesalers/{id}/listings | Every Investorlift listing of theirs. |
422 wholesale_unavailable.
meta.coverage[].wholesale_as_of tells you in advance.One Investorlift listing company in one market: names and entities, listing counts by what the deeds show, and the investors who buy from it.
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.
^wsr_[0-9a-f]{12}$Market code, for example phx. A company that lists in two markets has a row per market.
The company's name as it appears on Investorlift, for example "Home Team Investors".
The other names the company markets under. Empty when none.
One brand name.
The legal entities behind the listing company, as far as its contracts and account show them. Business names, which the API serves to every key.
Show child attributes
Show child attributes
The 2-letter state of the company's Investorlift account. Null when unknown.
The company's own investor id when it is itself a registry investor: the key to its buying history at GET /v1/investors/{id}. That is when its title or its own entities appear as deed names of one investor. Null when the company never appears on a deed as an investor.
^inv_[0-9a-f]{12}$The company's account id in the Investorlift app: the join key back to the app.
-9007199254740991 <= x <= 9007199254740991Every listing the company published in the market, matched to a parcel or not.
-9007199254740991 <= x <= 9007199254740991Listings closed by a recorded deed with the credit on this company (CONFIRMED, PRIMARY): the company's verified wholesale transactions.
-9007199254740991 <= x <= 9007199254740991Of the verified transactions, the ones bought by a known investor (tiers REGISTRY_STRONG, REGISTRY_WEAK, IL_BUYER_CONFIRMED).
-9007199254740991 <= x <= 9007199254740991Listings the company closed through a double close, that is two chained deeds 0 to 14 days apart.
-9007199254740991 <= x <= 9007199254740991Listings where the company held title at some point: as the intermediate, the seller, or the prior owner.
-9007199254740991 <= x <= 9007199254740991Listings that closed to an owner-occupant or through the MLS (verification RETAIL).
-9007199254740991 <= x <= 9007199254740991Listings with no recorded transfer by the deed data_end (verification OPEN).
-9007199254740991 <= x <= 9007199254740991Listings with no transfer recorded within 400 days (outcome NO_TRANSFER_400).
-9007199254740991 <= x <= 9007199254740991Every listing with verification NONE: no transfer, a distressed deed, an unattributable transfer, or the credit on another listing of the parcel.
-9007199254740991 <= x <= 9007199254740991Listings that share their closing deed with another company's listing of the same parcel (lister_attribution SHARED(n)).
-9007199254740991 <= x <= 9007199254740991The company's oldest listing in the market, YYYY-MM-DD. Null when it has no matched listing.
The company's newest listing in the market, YYYY-MM-DD. Null when it has no matched listing.
Listings published in the 365 days that end on the deed data_end.
-9007199254740991 <= x <= 9007199254740991Median asking price over the company's priced listings, whole dollars. Null when no listing carries a price.
-9007199254740991 <= x <= 9007199254740991Median days from publication to the closing deed over the company's CONFIRMED listings, for example 31.5. Null when the company has no CONFIRMED listing.
The investors who bought most often from this company, most first, at most 5. Empty when no known investor bought.
Show child attributes
Show child attributes
The deed data end date, YYYY-MM-DD. The API measures the windows against it.
Was this page helpful?