The Companies API
for LuumenAI

Company data, technology footprints, and saved lists from your terminal

Look up a company by domain, search the database by industry, technology, or location, and see what is already in your saved lists. The Companies API answers those questions in the terminal, next to the systems you already run. Creating, renaming, and deleting lists are previewed and approved before anything changes. Luumen connects with an API key.

The The Companies API toolbox

10 tools: 7 read, 3 write. Reads answer instantly. Writes require approval by default. Everything is logged.

  • ReadEnrich Job TitleNormalize a job title and infer its department and seniority classification.
  • ReadGet Account ContextReturn the connected user, current team, subscription state, and remaining credit balance.
  • ReadGet CompanyReturn the cached company profile for an exact domain, optionally in a compact form; this tool does not force a paid refresh.
  • ReadList Companies In ListReturn one page of companies currently contained in a specified company list.
  • ReadList ListsReturn one page of company lists owned by the connected account.
  • ReadSearch CompaniesSearch the company database with text or structured segmentation conditions and return one page of matching company profiles.
  • ReadSearch TaxonomySearch provider taxonomy values for industries, technologies, or geographic levels and return normalized identifiers for company filters.
  • WriteCreate ListCreate an empty static company list with email notifications disabled. Approval by default
  • WriteDelete ListPermanently delete a company list by ID and return the deleted list record. Approval by default
  • WriteRename ListRename an existing company list without changing its query, synchronization, or notification settings. Approval by default

One prompt, start to finish

What a governed The Companies API run looks like inside Luumen.

Questions

How does LuumenAI connect to The Companies API?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in The Companies API on its own?

Read actions answer immediately. Anything that writes — create list, delete list, rename list — is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.

Who gets access to the integration?

You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.

Is there an audit trail?

Every call to The Companies API — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put The Companies API to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.