Find duplicate anagrafiche
Reports existing anagrafiche that a new one would arguably duplicate, matched on partita IVA, codice fiscale or email and ranked by how many of the three collide. It REPORTS and never blocks: a partita IVA is not unique here — branches of a group share one, and so do a person and their ditta individuale — so call this before anagrafiche_create_party and show the user what came back rather than refusing. Names are deliberately not compared. When the organisation has the duplicate warning switched off this says so instead of answering with an empty list, because «I looked and found nothing» and «nobody looked» are different facts.
Examples
- Before I add them — do we already have this company? P. IVA 12345678903 GET /api/v1/rest/anagrafiche/duplicates?vat_number=12345678903
- Is amministrazione@rossi.example already in the register? GET /api/v1/rest/anagrafiche/duplicates?email=amministrazione%40rossi.example
- I am editing this record — anything else with the same P. IVA? GET /api/v1/rest/anagrafiche/duplicates?vat_number=00743110157&exclude_id=11111111-2222-4333-8444-555555555555
Request
- Base URL: https://api.custodo.ai
- URL: https://api.custodo.ai/api/v1/rest/anagrafiche/duplicates
- Auth: HTTP bearer
Query parameters
Partita IVA, in any spelling: it is normalised the same way a stored one was.
Codice fiscale, in any spelling.
Compared case-insensitively.
The anagrafica you are about to EDIT. Without it that record reports itself as its own duplicate.
Headers
The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.
Response
Done. data is the tool’s own answer.
Changes
No recorded changes to this operation across all 1 revision of this API.