> ## 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.

# The Wholesaler object

> An Investorlift listing company: what it listed, how fast it closes, and who buys from it.

<Note>
  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.
</Note>

A wholesaler is an Investorlift **listing company**, with the id `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 its
  `name` (the deed spelling) and, since 0.31.0, its `display_name` to print.

The API judges all of it by the county deeds, never by the listing status in the Investorlift app.

| Endpoint                                                                             | What it gives you                                                                 |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| [`GET /v1/wholesalers/search`](/api-reference/endpoints/wholesalers-search)          | The company id, from a name, a brand or an entity name.                           |
| [`GET /v1/wholesalers/{id}`](/api-reference/endpoints/wholesalers-get)               | The profile below.                                                                |
| [`GET /v1/wholesalers/{id}/listings`](/api-reference/endpoints/wholesalers-listings) | Every [Investorlift listing](/api-reference/objects/wholesale-listing) of theirs. |

In a market with no published wholesale tables, the API answers `422 wholesale_unavailable`.
`meta.coverage[].wholesale_as_of` tells you in advance.


## Related topics

- [Changelog](/changelog.md)
- [The Investorlift listing object](/api-reference/objects/wholesale-listing.md)
- [API reference](/api-reference/introduction.md)
- [The Investor object](/api-reference/objects/investor.md)
- [The Deal object](/api-reference/objects/deal.md)