# HigherData

HigherData finds companies and people. Call a tool with a Bearer API key.

## Tools

- account.whoami: Returns the tenant, space, and principal for this request. Costs 0 units. POST /api/v1/tools/account.whoami
- lists.add: Add up to 50 opaque company or people ids to a matching saved list, with current release projections. Dry run previews the items. Costs 0 units until the units ledger is enabled. POST /api/v1/tools/lists.add
- lists.create: Create a saved company or people search in the current space. Recurring refresh is opt-in and runs once per warehouse release, up to 1,000 saved items. Dry run previews the definition. Costs 0 units until the units ledger is enabled. POST /api/v1/tools/lists.create
- lists.export: Export a saved list as paged CSV or JSONL with opaque ids. CSV escapes spreadsheet formulas. Pages contain at most 50 records. Costs 0 units. POST /api/v1/tools/lists.export
- lists.get: Read lists in this space, or one list with its items and recent runs. Pages contain at most 50 records. Costs 0 units. POST /api/v1/tools/lists.get
- lists.run: Queue a bounded company-first refresh for the current warehouse release when background jobs are configured, or return jobs_unavailable. Runs are idempotent per list and release. Dry run returns the proposed release without writing or dispatching. Costs 0 units until the units ledger is enabled. POST /api/v1/tools/lists.run
- lookup.company: Look up a company by exactly one domain, exact name (optionally with location), or opaque hdo_ id. Returns bounded candidates and ambiguity metadata. Costs 0 units until the units ledger is enabled; no match costs 0. POST /api/v1/tools/lookup.company
- lookup.person: Look up a person by exactly one work email, LinkedIn profile URL or opaque hdp_ id. LinkedIn and id matching include people without email. Costs 0 units until the units ledger is enabled; no match costs 0. POST /api/v1/tools/lookup.person
- search.companies: Find companies in HigherData Core using explicit filters. Pages contain at most 50 records and opaque ids. Costs 0 units until the units ledger is enabled; empty pages cost 0. POST /api/v1/tools/search.companies
- search.count: Estimate companies and associated contacts from release-built TAM aggregates. isIcpBaseline marks refinements that the aggregate cannot represent. Costs 0 units until the units ledger is enabled. POST /api/v1/tools/search.count
- search.facets: Read available country, state, industry and funding filter values from HigherData Core. Costs 0 units until the units ledger is enabled. POST /api/v1/tools/search.facets
- search.filters_from_text: Turn a sentence into proposed editable filters with a short explanation. Does not execute a search. Costs 0 data units; AI usage is recorded separately in the tenant's configured mode. POST /api/v1/tools/search.filters_from_text
- search.people: Find people in HigherData Core, with 1 to 5 positive country codes or industries required. Pages contain at most 50 people and opaque ids. Costs 0 units until the units ledger is enabled; empty pages cost 0. POST /api/v1/tools/search.people