Skip to main content
GET
Get the profile of one Investorlift listing company
Early access: while the developer tier is in beta, the API serves this route to Investorlift’s team and trusted partners. Investorlift will restrict the route further before it opens to every key.
One Wholesaler: who the company is and how its listings end.

Use it when

The wholesaler card. You open it from a wholesale row’s wholesaler.id or from a search hit. For its listings, use GET /v1/wholesalers/{id}/listings.

Read the response

  • n_verified is the number that matters: the listings that a recorded deed closed with the credit on this company. n_to_investors is how many of those went to a known investor. n_listings counts every listing, matched to a parcel or not. So the gap between the two is the true gap.
  • n_open is the listings with no recorded transfer yet. n_no_transfer is the listings with no transfer within 400 days. n_none is every listing whose verdict is NONE, and that verdict is wider than “no deed”. It includes no transfer, a distressed deed, or a transfer the rules cannot tie to this listing. It also includes a credit that went to another listing of the parcel. n_retail is the listings that closed to an owner-occupant or through the MLS.
  • The API sets investor_id when the company is itself a registry investor. Its own buying history is at the investor profile.
  • top_buyers[] are the investors who bought most from this company, each with its market-wide summary.

Gotchas

  • The id must carry the wsr_ prefix. Otherwise the API answers 400 invalid_id. The API answers 404 for an id not on file.
  • Wholesaler ids have no alias table. An id is stable per company, so this route never answers 410 gone.
  • Pass market when the company lists in more than one loaded market. If you omit it there, the API answers 400 market_required.
  • The API serves every field to every key: these are business names.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Wholesaler id, wsr_ followed by 12 hex characters, for example wsr_3f9a1c27b4e0, from any wholesale row's wholesaler.id or a search hit. The id is stable per company and has no alias table.

Query Parameters

market
string

Market code, for example phx. The loaded markets are in meta.coverage[]. Send it only when the id exists in more than one loaded market. 400 market_required says so, and a company that lists in two markets has a profile in each market. Otherwise the API uses the id's own market.

Required string length: 1 - 16

Response

The company profile.

The company profile.

data
object
required

One Investorlift listing company in one market: names and entities, listing counts by what the deeds show, and the investors who buy from it.

meta
object
required

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