--- name: "companies_get" area: "companies" title: "Look up a company's profile" price: "$0.05" method: "POST" url: "https://api.conecto.chat/v1/tools/companies_get" mcp_server: "https://api.conecto.chat/mcp/companies" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/companies/companies_get" --- # Look up a company's profile (`companies_get`) A company's record in its register: legal form, status, address, industry, employees, LEI and its officers by name and role. A company's record in its register: legal name and form, status, founding date, address, industry codes with their NACE label (NACE Rev. 2.1 for Norway and newer Finnish filings, with rev2: the Rev. 2 codes the other tools take), employees where published, VAT numbers, its LEI, and its officers by name and role (never birth dates or contacts). US companies add tickers and recent filings. Each fact comes with its register, link and license. Price: $0.05 a call. A call that fails costs nothing. ## Use it when Before a first call or an offer, to know who you are dealing with. ## Say this to your agent > Who runs Arnestad Storkjøkken, and how many people work there? ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `company` | string | yes | A company id from companies_search: fr:306138900, gb:08123456, no:923609016, fi:1927400-1, us:769520 or lei:529900K139N6UFJ1A758. 4 to 40 characters. | | | ## Example Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. MCP: call `companies_get` on the MCP server `https://api.conecto.chat/mcp/companies` with these arguments: ```json { "company": "no:961920566" } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/companies_get \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"company": "no:961920566"}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "companies_get", "status": "succeeded", "replayed": false, "cost_usd": "$0.05", "balance_usd": "$19.75", "result": { "company": { "id": "no:961920566", "name": "ARNESTAD STORKJØKKEN AS", "country": "NO", "number": "961920566", "status": "active", "city": "Oslo", "industry": { "scheme": "NACE Rev. 2.1", "code": "46.49", "label": "Wholesale of other household goods" }, "founded": "1991-09-01", "legal_form": "Private limited company (AS)", "address": { "line": "Professor Birkelands vei 24A", "postcode": "1081", "city": "Oslo", "country": "NO" }, "industry_codes": [ { "scheme": "SN2025", "code": "46.490", "label": "Engroshandel med andre husholdningsvarer" } ], "employees": 11, "website": null, "officers": [ { "name": "Kari Nordmann", "role": "Managing director", "kind": "person" }, { "name": "Kari Nordmann", "role": "Chair of the board", "kind": "person" } ], "sources": [ { "register": "Norway (Brønnøysundregistrene)", "url": "https://data.brreg.no/enhetsregisteret/oppslag/enheter/961920566", "license": "NLOD 2.0", "retrieved": "2026-10-24" } ] } } } ``` `result`: company: id, name, legal_name, legal_form, status, founded, address, industry (rev2 where it is NACE Rev. 2.1) and industry_codes, employees, website, vat, lei, also (its other ids), officers (name, role, kind), and sources (register, url, license, retrieved); US companies add tickers, exchanges and recent_filings. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | The id isn't one of fr:, gb:, no:, fi:, us: or lei: with a valid number. | Use an id from companies_search, like no:961920566. | | `not_found` | 404 | The register has no company with that id. | Find it by name with companies_search. | | `unavailable` | 503 | A register didn't answer, or the UK register isn't connected yet. | Try again in a minute. For a UK company, search by name and use its LEI. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [companies_search](https://conecto.chat/tools/companies/companies_search.md): Companies by name or id across the public registers, each with its id, country, status, city and industry, best match first. Free up to 1,000,000 reads a month. - [companies_financials](https://conecto.chat/tools/companies/companies_financials.md): Up to ten years of a company's filed figures in one shape, each with its source document, plus growth, margins, returns and payment days. $0.05 a call. - [companies_save_accounts](https://conecto.chat/tools/companies/companies_save_accounts.md): A UK company's annual accounts as filed with Companies House, saved to the file store as a PDF: the latest, or a year's. $0.001 a call. - [companies_read_accounts](https://conecto.chat/tools/companies/companies_read_accounts.md): The balance sheet and income statement read out of an annual report PDF, a scan by OCR, line by line with its page, German HGB or English. $0.05 a call. - [companies_owners](https://conecto.chat/tools/companies/companies_owners.md): A company's parents and subsidiaries from GLEIF, the SEC and Wikidata and, in the UK, the people and companies with significant control. $0.05 a call. - [companies_legal_notice](https://conecto.chat/tools/companies/companies_legal_notice.md): A company's legal notice (Impressum) read from its own website: legal name, register court and number, managers and VAT number. $0.01 a call. - [companies_estimate](https://conecto.chat/tools/companies/companies_estimate.md): A revenue estimate from headcount and Eurostat's turnover per person employed for the size class and industry, always labeled as an estimate. Free up to 1,000,000 reads a month. - [companies_match](https://conecto.chat/tools/companies/companies_match.md): Matches a company list (CSV, Excel or rows) to the registers in the background, with a results file of each match. $0.01 per row matched.