Skip to main content
syrto_find_person resolves a human name into person IDs. Use those IDs in the people section of syrto_search_companies or syrto_aggregate_companies to find every company a person is an officer, shareholder, or beneficial owner of.

​
Use this tool to

  • Look up a person by name and get their person ID
  • Tell apart several people who share a name, using birth date, gender, and their company involvements
  • Build the people filter for a company search
Related tools: For companies rather than people, use Find company.

​
Arguments

​
string
required
Full name to resolve (max 200 characters). The registry stores names surname-first - "Rossi Mario", not "Mario Rossi" - and matching is on exact spelling, with no fuzzy matching, so a misspelled name returns nothing.Capitalise the name as it is stored. Only the exact-match rung is case-sensitive, so a lower-cased name skips it and answers from the prefix rung instead, losing exact-first ranking.Word order is handled for you: when the given order finds nobody, reversed orders are retried automatically.
​
string
How the name is matched.
​
string
Pagination cursor. Pass end_cursor from the prior response with the same name to fetch the next page. A cursor is bound to the match rung it was issued for - pair it with that same match value, or drop it to start a new search.
​
string
"en" for English (default) or "it" for Italian.

​
How matching works

Exactly one of three rungs answers each call: the name matched exactly if anybody carries it, else as a prefix, else as a substring. This is what puts the person you asked for at the top of page 1 - a search for "Conti Marco" returns the people actually called that, instead of burying them behind the "Arconti Marco" and "Buoninconti Marco" that alphabetical order puts first. The trade-off is that only one rung answers at a time. warning names the rung whenever it is not the widest one and says how to widen; widening re-lists the narrower matches alongside the rest.

​
Returns

Paginated results:
​
boolean
Whether another page is available. This tool returns up to 20 people per page.
​
string | null
Cursor for the next page. Pass it back as after, together with the name these results were found under - when warning names a different word order, use that reordered name.
​
object[]
Matching people, each with:
  • id - the person ID to use in the people search filter
  • full_name - name as stored, surname-first
  • birth_date and gender - raw values, to tell namesakes apart
  • officerships, shareholdings, beneficial_ownerships - up to five each, giving the companies the person is involved with
​
string | null
Present when the match rung was narrower than the widest, when a reversed word order answered instead of the one you typed, or when nothing matched at all.
The company entries under officerships, shareholdings, and beneficial_ownerships identify their company by tax_id, not by company ID. To analyse those companies, collect the tax IDs and pass them to syrto_lookup_companies_by_tax_id (up to 20 in one call), then use the company IDs it returns.tax_id is omitted on the rare entry the registry has no tax ID for, and a tax ID may come back not_found. In both cases that company is identifiable by legal_name only.
When nothing matches, the result is an empty items list with guidance in warning - not an error.

​
Example

Look up a person:
Widen to compound surnames:
Returns the people called exactly "Conti Marco" alongside longer names containing it, such as "Bonanno Conti Marco".