Skip to main content
GET
Find an Investorlift listing company by name, brand or entity
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.
The route returns the stable wholesaler id. Use it to open a profile.

Use it when

You build a wholesaler typeahead. You have a company name and need its id.
If you already have a listing, skip the search. Every wholesale row carries wholesaler.id.

Read the response

match says how the API found the hit, best first: exact, tokens, contains, then trigram. A tokens hit has every word of the query in one of the company’s names, in any order. A trigram hit is fuzzy. The API tries it only when fewer than 10 companies matched otherwise, and then sets similarity. matched_name is the name that hit: the Investorlift name, a brand, or an entity name from its contracts. Within one match level, the companies with the most verified transactions come first. page.capped is true when the API cut the page at limit. The envelope’s page block has the rule and what to do when it is true. Without market=, the API searches every loaded market with wholesale tables. A company that lists in two markets appears once per market.

Gotchas

  • A query of fewer than three letters or digits after normalisation is a 400.
  • No cursor: page.next_cursor is always null.
  • Every name here is a business name. The API serves it in full.
  • A market with no published wholesale tables answers 422 wholesale_unavailable. With no market loaded at all, the search answers 503 not_ready.

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 company to look for: its Investorlift name ("Home Team Investors"), a brand, or a legal entity name ("HOME TEAM INVESTORS LLC"). Part of one is enough. Case and punctuation do not matter. At least 3 letters or digits after normalisation (400 otherwise).

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, 422 wholesale_unavailable when it has no published wholesale tables. Without it the API searches every loaded market with wholesale tables and each hit carries its market.

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

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

Required range: 1 <= x <= 50

Response

Companies whose name, brand or entity name matches the query, best match first. page.next_cursor is always null and page.capped is true when the API cut the page at limit.

Companies whose name, brand or entity name matches 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.