openapi-company · diff
git:20260610.a6e7f3f to git:20260610.0dfad19
27 added, 16 removed. Audit A to A.
---
name: openapi-company
- description: Look up company/business data through Openapi - Italian companies by VAT/tax code or name, European and worldwide company search, legal forms, company credit scores. Use for questions like "find data about company X", "who owns VAT number Y", "search companies in France/EU/worldwide".
+ description: Look up company/business data through Openapi - Italian companies by VAT/tax code or name, European and worldwide company search, shareholders, UBO, AML, PEC/SDI codes, company monitoring. Use for questions like "find data about company X", "who owns VAT number Y", "search companies in France/EU/worldwide".
---
# Openapi Company data
Base URL: `https://company.openapi.com` — company master data from official registers (Chamber of Commerce, CRIF, INPS and more).
- Authentication: Bearer token with `company.openapi.com` scopes — see the `openapi-auth` skill.
+ Authentication: `Authorization: Bearer <token>` with `company.openapi.com` scopes — see the `openapi-auth` skill.
- ## Choosing the right endpoint
+ ## Italian companies (by VAT or tax code)
- | Need | Endpoint |
+ | Endpoint | Returns |
|---|---|
- | Quick Italian company lookup (cheap) | `GET /IT-start/{vat_or_taxcode}` |
- | Full Italian company report | `GET /IT-full/{vat_or_taxcode}` |
- | Advanced Italian data (async) | `GET /IT-advanced/{id}` after starting a request |
- | Search Italian companies by name/filters | `GET /IT-search` |
- | Italian legal forms list | `GET /IT-legalforms` |
- | French companies | `GET /FR-search` |
- | Other EU countries (async start/advanced) | `EU-start` → `EU-advanced` |
- | Worldwide (async) | `WW-start` → `WW-advanced`; quick top-level: `WW-top` |
- | Credit score (top-level) | see `risk` service (`openapi-risk` skill) |
+ | `GET /IT-start/{vatCode_taxCode_or_id}` | Basic data (cheap, start here) |
+ | `GET /IT-advanced/{vatCode_taxCode_or_id}` | Advanced data |
+ | `GET /IT-full/{vatCode_or_taxCode}` | Everything (most expensive) |
+ | `GET /IT-search` | Search by name/filters |
+ | `GET /IT-shareholders/…` / `GET /IT-ubo/…` | Shareholders / ultimate beneficial owners |
+ | `GET /IT-aml/…` | Anti-money-laundering data |
+ | `GET /IT-pec/…` / `GET /IT-sdicode/…` | Certified e-mail / SDI invoicing code |
+ | `GET /IT-address/…`, `/IT-name/…`, `/IT-closed/…`, `/IT-vatgroup/…`, `/IT-splitpayment/…`, `/IT-pa/…` | Address, name, activity cessation, VAT group, split payment, public administration |
+ | `GET /IT-legalforms` | Italian legal forms list |
+ | `GET /IT-check_id/{id}` | Status of an async request |
- The async pattern (start → poll advanced with the returned `id`, or pass a `callback` URL) is described in the [platform guide](../../knowledge/platform-guide.md#async-request-pattern).
+ POST variants of `/IT-full`, `/IT-aml`, `/IT-marketing`, `/IT-stakeholders` run asynchronously: pass a `callback` URL or poll `GET /IT-check_id/{id}`.
+ ## Other countries
+
+ - Dedicated start/advanced pairs: `FR` (also `/FR-search`), `DE`, `ES`, `PT`, `GB`, `BE`, `AT`, `CH`, `PL` — e.g. `GET /FR-start/{siret_siren_or_vat}`.
+ - Worldwide: `GET /WW-start/{country}/{id}`, `GET /WW-advanced/{country}/{id}`, `GET /WW-top/{country}/{id}`.
+
+ ## Monitoring
+
+ `POST /monitor` registers a company for change notifications; `GET /monitor`, `GET/DELETE /monitor/{id}` manage registrations.
+
## Example
```bash
curl -s https://company.openapi.com/IT-start/12485671007 \
-H "Authorization: Bearer $OPENAPI_TOKEN"
```
## Notes
- - The legacy `imprese.openapi.it` API offers similar Italian lookups; prefer `company.openapi.com`. Sandbox test VAT numbers: https://docs.openapi.it/imprese-sandbox-examples.html
- - Full spec: [knowledge/oas/company.openapi.json](../../knowledge/oas/company.openapi.json) · endpoints: [knowledge/services/company.md](../../knowledge/services/company.md) · legacy: [knowledge/services/imprese.md](../../knowledge/services/imprese.md)
+ - Sandbox test companies: https://docs.openapi.it/company-sandbox-examples.html
+ - The legacy `imprese.openapi.it` API offers similar Italian lookups; prefer `company.openapi.com`.
+ - Full spec: https://console.openapi.com/oas/en/company.openapi.json