Matchplat API Docs

POST /explore/one

Recupera i dati di una azienda dato il nome o la partita IVA, con possibilità di affinare la ricerca tramite nazione, CAP e regione. Se la ricerca avviene per nome, restituisce fino a 5 aziende simili; se per partita IVA, restituisce un solo match esatto.

Request Body

Campo Tipo Descrizione
companyName String Ragione sociale dell'azienda (opzionale, ma almeno uno tra companyName o vatTaxNumber è richiesto)
country String Codice nazione ISO2 (obbligatorio)
vatTaxNumber String Partita IVA/VAT ID (opzionale, ma almeno uno tra companyName o vatTaxNumber è richiesto)
postCode String CAP/Postcode (opzionale)
region String Regione (opzionale, valore da endpoint GET Regions). Vedi qui

Risposta 200

Campo Tipo Descrizione
companies Company[] Array di oggetti azienda trovati (max 5 per ricerca per nome, 1 per partita IVA)

Company

Vedi la sezione Oggetto Azienda per la descrizione dettagliata dei campi company.

Esempio

{
  "companies": []
}

Esempio chiamata curl

curl -X POST "/explore/one" \
  -H "x-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Matchplat Srl",
    "country": "IT",
    "vatTaxNumber": "",
    "postCode": "",
    "region": ""
  }'