Skip to main content
GET
Find an investor by any name it buys under
This route finds the investor that buys under a name. The search looks at every name on file for an investor, not just its registry name. So a person’s name finds the LLCs they buy through.

​
Use it when

The investor typeahead, one call per keystroke from the third character on. Also to map a name you already have to an id. Then call GET /v1/investors/{id}.

​
Read the response

match says how the search found the hit. The API returns the hits best first:
  • matched_name is the deed name that matched, which is often not the display name. If matched_is_person is true, the match was a principal, not the entity.
  • Within one match level, the investors with the most deals come first.
  • page.capped is true when limit cut the page. The envelope’s page block has the rule and what to do then.
  • Without market= the search covers every loaded market. Each hit carries its market, and meta.coverage[] lists the markets the search covered. The API hashes investor ids from the deed names, so the same id can exist in two markets. Such an id then appears once per market. Pass market= to narrow the search, and pass it on to the profile route for such an id.

​
Gotchas

  • For fewer than three letters or digits after normalisation, the API answers a 400.
  • The search hides seller-only profiles (builders that never bought) unless n_deals_min=0, and public bodies unless include_public=true. This route never hides institutional investors.
  • No cursor: page.next_cursor is always null.
  • For market= with a name outside the loaded markets, the API answers a 400. With no market loaded at all, the API answers 503 not_ready.
  • A hit that the search found through a person’s name comes back with matched_name and matched_party_key null and contact_redacted: true. That is because this host does not serve a person’s name. You can still open the profile by id.
I know the name, find the investor.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
q
string
required

The name to look for: an entity ("ZAK VENTURES"), a person in either order ("Dana Rivera" or "RIVERA DANA"), or part of one. Case and punctuation do not matter. The name needs at least 3 letters or digits after normalisation. The API answers 400 to a shorter name.

Required string length: 1 - 200
​
market
string

Market code, for example phx. The loaded markets are in meta.coverage[]. It narrows the search to that market. The API answers 400 when that market is not loaded. Without it the API searches every loaded market and each hit carries its market.

Required string length: 1 - 16
​
limit
integer
default:10

Investors to return, 1 to 50 (default 10).

Required range: 1 <= x <= 50
​
n_deals_min
integer
default:1

Minimum investment deals as buyer inside the area loaded for the market, 0 to 1,000,000 (default 1). The default hides seller-only profiles, for example builders that never bought. A value of 0 shows them.

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

Include public bodies (counties, cities, housing authorities). Default: false.

Available options:
true,
false

Response

Investors whose deed names match the query, best match first. page.next_cursor is always null and page.capped is true when the API cut the page at limit.

Investors whose deed names match the query, best match first. page.next_cursor is always null and page.capped is true when the API cut the page at limit.

​
data
object[]
required

The hits, best match first.

​
page
object
required

The page block of a name search: no cursor, the limit applied, the hits returned and if the API cut the page at the limit.

​
meta
object
required

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