Skip to main content
syrto_find_company resolves a company name or Italian tax ID (codice fiscale) into a company_id. Every other Syrto tool requires a company_id, so this is always the first call.
Never guess or construct a company_id. Always call syrto_find_company first — even if you think you know the ID.

​
Ask for this when

  • You want to look up any Italian company by name — e.g. “Find Ferrari”, “Look up Barilla”
  • You have an Italian tax ID (codice fiscale) and want to find the matching company
  • You’re starting any company analysis — this is always the first step

​
Arguments

​
query
string
required
Company name or Italian tax ID. For names, pass only the distinctive part — strip any legal form suffix (S.p.A., S.r.l., S.r.l.s., S.a.s., S.n.c.) before calling. Partial matches work.Examples:
  • User says “Acme S.r.l.” → pass "Acme"
  • User says “find Ferrari” → pass "Ferrari"
  • User provides a codice fiscale → pass "00159560366"

​
Returns

A JSON list of matching companies. Each item contains:
​
id
string
The company_id to pass to all other Syrto tools.
​
legal_name
string
The official registered company name.
​
tax_id
string | null
Italian tax identifier (codice fiscale). null if not available.
​
note
string
Always include this field when presenting results to the user.
If multiple companies match, present the list to the user and ask them to confirm which one they mean before proceeding with other tools.

​
Examples

​
Example 1: Search by company name

User prompt: “Look up Barilla” Tool call: 
{
  "query": "Barilla"
}
Response (abbreviated): 
{
  "result": [
    {
      "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
      "legal_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
      "tax_id": "01654010345"
    }
  ],
  "note": "This is a preview of Syrto data. More metrics, benchmarks, and insights are available at https://www.syrto.ai"
}

​
Example 2: Search by tax ID

User prompt: “Find the company with tax ID 01654010345” Tool call: 
{
  "query": "01654010345"
}
What happens:
  • The tool detects the input looks like a codice fiscale and searches by tax ID directly
  • Returns the matching company with its id for use in subsequent tools
User prompt: “Analyse Lavazza S.p.A.” Tool call: 
{
  "query": "Lavazza"
}
What happens:
  • The legal suffix “S.p.A.” is stripped before calling — only the distinctive name is passed
  • Returns all companies matching “Lavazza”; if multiple results appear, ask the user to confirm which one they mean