Skip to main content
syrto_lookup_companies_by_tax_id resolves a list of Italian tax IDs (codice fiscale or partita IVA) into company IDs. Each tax ID is checked against both the EU VAT number and the taxpayer identification number on file.
For looking up a single company by name or tax ID, use syrto_find_company instead. This tool is designed for batch resolution when you already have multiple tax IDs.

​
Use this tool to

  • Resolve multiple tax IDs to company IDs in one call (up to 20)
  • Check which tax IDs match a known company and which do not
  • Get the company IDs that most other Syrto tools take when starting from tax identifiers
Related tools: For single-company lookup by name or tax ID, use Find company.

​
Arguments

​
string[]
required
List of tax IDs to resolve (min 1, max 20). Each entry can be up to 200 characters. Each tax ID is matched against both EU VAT number and taxpayer identification number fields.Example: ["01654010345", "00159560366"]
​
string
Which financial statement each tax ID resolves to. individual_only (default) is the statement the company filed for itself, consolidated_only its group’s statement, and both returns one entry per statement the company files. Under both, a tax ID filing both statements gets two entries, distinguished by company.consolidated.
​
string
"en" for English (default) or "it" for Italian.

​
Returns

A JSON list in the same order as the input tax_ids - except under statement_basis: "both", where a tax ID filing both statements gets two entries. Each item contains:
​
string
The entry from your tax_ids list that this item answers for, exactly as you sent it.
​
string
"resolved" if a matching company was found, "not_found" otherwise.
​
object
Present when status is "resolved", and omitted otherwise. Contains:
  • id - the company ID to pass to other Syrto tools in their company_ids list
  • legal_name - official registered company name
  • eu_vat_number - EU VAT number (omitted if not available)
  • taxpayer_identification_number - Italian codice fiscale (omitted if not available)
  • consolidated - false = the company’s own individual figures, true = its group’s consolidated figures
Under statement_basis: "consolidated_only", warning is present when some tax IDs did not resolve: most Italian companies file only an individual statement, so those are worth retrying on the default basis. Beside the list, the response carries the fields every tool returns. Here display_title is the resolved company’s legal name, or a count when several resolved, and subtitle says how many tax IDs were not found.

​
Example

Resolve two tax IDs:
Response: