> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cerca aziende per codice fiscale

> Risolvi in batch fino a 20 codici fiscali in company ID con una singola chiamata.

`syrto_lookup_companies_by_tax_id` risolve una lista di codici fiscali o partite IVA italiane in valori `company_id`. Ogni codice fiscale viene verificato sia contro il numero di partita IVA UE sia contro il codice fiscale registrato.

<Tip>
  Per cercare una singola azienda per nome o codice fiscale, usa [`syrto_find_company`](/it/mcp/tools/find-company). Questo strumento è pensato per la risoluzione in batch quando si hanno già più codici fiscali.
</Tip>

## Quando usare questo strumento

* Risolvere più codici fiscali in company ID con una sola chiamata (fino a 20)
* Verificare quali codici fiscali corrispondono a un'azienda nota e quali no
* Ottenere il `company_id` richiesto dalla maggior parte degli altri strumenti Syrto partendo da identificativi fiscali

**Strumenti correlati:** Per la ricerca di una singola azienda per nome o codice fiscale, usa [Cerca azienda](/it/mcp/tools/find-company).

## Argomenti

<ParamField query="queries" type="string[]" required>
  Lista di codici fiscali da risolvere (min 1, max 20). Ogni voce può contenere fino a 200 caratteri. Ogni codice fiscale viene confrontato sia con il numero di partita IVA UE sia con il codice fiscale registrato.

  **Esempio:** `["01654010345", "00159560366"]`
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

## Risposta

Una lista JSON nello stesso ordine delle `queries` in input. Ogni elemento contiene:

<ResponseField name="query" type="string">
  Il codice fiscale originale dalla richiesta.
</ResponseField>

<ResponseField name="status" type="string">
  `"resolved"` se è stata trovata un'azienda corrispondente, `"not_found"` altrimenti.
</ResponseField>

<ResponseField name="company" type="object | null">
  Presente quando `status` è `"resolved"`. Contiene:

  * `id` — il `company_id` da passare a tutti gli altri strumenti Syrto
  * `legal_name` — ragione sociale ufficiale dell'azienda
  * `eu_vat_number` — numero di partita IVA UE (`null` se non disponibile)
  * `taxpayer_identification_number` — codice fiscale italiano (`null` se non disponibile)
</ResponseField>

## Esempio

**Risolvere due codici fiscali:**

```json theme={null}
{
  "queries": ["01654010345", "00000000000"]
}
```

**Risposta:**

```json theme={null}
{
  "result": [
    {
      "query": "01654010345",
      "status": "resolved",
      "company": {
        "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
        "legal_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
        "eu_vat_number": "01654010345",
        "taxpayer_identification_number": "01654010345"
      }
    },
    {
      "query": "00000000000",
      "status": "not_found",
      "company": null
    }
  ]
}
```