---
title: "The Companies API integration for LuumenAI"
url: "https://www.luumen.ai/integrations/the-companies-api/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# The Companies API integration for LuumenAI

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

## What LuumenAI can do with The Companies API

LuumenAI connects to The Companies API with an API token and exposes 10 tools (7 read-only · 2 write · 1 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 10 tools (7 read-only · 2 write · 1 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About The Companies API with LuumenAI

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.

## Example tools

Read-only (7 in total):

- `THECOMPANIESAPI_ENRICH_JOB_TITLE` — Normalize a job title and infer its department and seniority classification.
- `THECOMPANIESAPI_GET_ACCOUNT_CONTEXT` — Return the connected user, current team, subscription state, and remaining credit balance.
- `THECOMPANIESAPI_GET_COMPANY` — Return the cached company profile for an exact domain, optionally in a compact form; this tool does not force a paid refresh.
- `THECOMPANIESAPI_LIST_COMPANIES_IN_LIST` — Return one page of companies currently contained in a specified company list.
- `THECOMPANIESAPI_LIST_LISTS` — Return one page of company lists owned by the connected account.
- `THECOMPANIESAPI_SEARCH_COMPANIES` — Search the company database with text or structured segmentation conditions and return one page of matching company profiles.
- `THECOMPANIESAPI_SEARCH_TAXONOMY` — Search provider taxonomy values for industries, technologies, or geographic levels and return normalized identifiers for company filters.

Write and destructive (3 in total, subject to configured approval policy):

- `THECOMPANIESAPI_CREATE_LIST` — Create an empty static company list with email notifications disabled.
- `THECOMPANIESAPI_DELETE_LIST` — Permanently delete a company list by ID and return the deleted list record.
- `THECOMPANIESAPI_RENAME_LIST` — Rename an existing company list without changing its query, synchronization, or notification settings.

## Frequently asked 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?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

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

Full page: https://www.luumen.ai/integrations/the-companies-api/