Imprese

URL: https://openapi.it/en/support License: Terms of Service

This service provides REST calls to extract information on businesses and companies from simple parameters such as denomination or VAT number

First time here? Generate a new access token

Company Information

Starting from basic data of a company such as VAT number, tax code or denomination, detailed information on the company itself is extracted

This service returns basic information of a company such as company name and address

Authorizations:

bearerAuth

path Parameters

piva_cf_or_id

required

string

Default: "<string>"

Example: 12485671007

VAT number, tax code or company ID

Responses

Response Schema: application/json

	object (Base)
success	boolean
message	string
error	integer

Response samples

Content type

application/json

{"data": {"cf": "12485671007",
"denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
"piva": "12485671007",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"civico": "221",
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"comune": "ROMA",
"frazione": null,
"provincia": "RM",
"stato_attivita": "ATTIVA",
"timestamp": 1622452306,
"timestamp_creation": 1622452306,
"timestamp_last_update": 1622452306,
"cap": "00143",
"codice_destinatario": "MJ1OYNU",
"id": "60b4a85585e34e615c569ef5",
"gps": {"coordinates": [12.47843,
41.8071
]
}
},
"success": true,
"message": "",
"error": null
}

With this service we can draw up a list of companies that correspond to certain parameters described below. The call returns a maximum of 100 results even if you set a higher limit.

Authorizations:

bearerAuth

query Parameters

denominazione	string Default: "<string>" Example: denominazione=altravia name of the company (you can search for parts of the name as long as they are whole words)
provincia	string Default: "<string>" Example: provincia=RM the code of the region you want to search in
codice_ateco	string Default: "<string>" Example: codice_ateco=6201 ateco code
cciaa	string Default: "<string>" Example: cciaa=RM Chamber of Commerce
rea	string Default: "<string>" Example: rea=1378273 rea code
fatturato_min	integer Default: "<integer>" Example: fatturato_min=100000 minimum revenue value
fatturato_max	integer Default: "<integer>" Example: fatturato_max=1000000 maximum revenue value
dipendenti_min	integer Default: "<integer>" Example: dipendenti_min=1 minimum value of employees
dipendenti_max	integer Default: "<integer>" Example: dipendenti_max=5 maximum value of employees
skip	integer Default: "<integer>" Example: skip=50 to set the number of records you want to skip from the result set
limit	integer [ 1 .. 100 ] Default: "<integer>" Example: limit=10 number of results you want to receive; if not set, the call will return a maximum of 100 results
dry_run	integer Default: "<integer>" Enum: 1 0 Example: dry_run=0 simulates a request by returning only the number of records found and the price
lat	number <double> [ -90 .. 90 ] Default: "<double>" Example: lat=13.5478 latitude
lng	number <double> [ -180 .. 180 ] Default: "<double>" Example: lng=42.859 longitude
radius	integer ( 0 .. 3000 ] Default: "<integer>" Example: radius=100 radius in meters

Responses

Response Schema: application/json

	Array of objects (BaseElenco) [ items ]
success	boolean
message	string
error	integer

Response samples

200
204
400
402
422

Content type

application/json

{"data": [{"cf": "12485671007",
"denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
"piva": "12485671007",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"civico": "221",
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"comune": "ROMA",
"frazione": null,
"provincia": "RM",
"stato_attivita": "ATTIVA",
"timestamp": 1622452306,
"timestamp_creation": 1622452306,
"timestamp_last_update": 1622452306,
"cap": "00143",
"id": "60b4a85585e34e615c569ef5",
"gps": {"coordinates": [12.47843,
41.8071
]
},
"dettaglio": {"codice_natura_giuridica": "SR"
}
},
{"cf": "00291570844",
"denominazione": "COM.MAR SRL",
"piva": "00291570844",
"toponimo": "VIA",
"via": "OLIMPICA",
"indirizzo": "VIA OLIMPICA",
"comune": "RAVANUSA",
"frazione": null,
"provincia": "AG",
"stato_attivita": "INATTIVA",
"timestamp": 1643049486,
"timestamp_creation": 1643049486,
"timestamp_last_update": 1643049486,
"cap": null,
"id": "61f2c4d69fb8571d19235463",
"gps": {"coordinates": [13.9730583,
37.2627218
]
},
"dettaglio": {"codice_natura_giuridica": "SR"
}
}
],
"success": true,
"message": "",
"error": null
}

This service gets advanced information about a company

Authorizations:

bearerAuth

path Parameters

piva_cf_or_id

required

string

Default: "<string>"

Example: 12485671007

VAT number, tax code or ID

Responses

Response Schema: application/json

	object (Advance)
success	boolean
message	string
error	integer

Response samples

Content type

application/json

{"data": {"cf": "12485671007",
"denominazione": "OPENAPI S.R.L.",
"piva": "12485671007",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"civico": "221",
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"comune": "ROMA",
"frazione": null,
"provincia": "RM",
"stato_attivita": "ATTIVA",
"timestamp": 1622452306,
"timestamp_creation": 1622452306,
"timestamp_last_update": 1622452306,
"dettaglio": {"rea": "1378273",
"cciaa": "RM",
"pec": "openapi@legalmail.it",
"codice_natura_giuridica": "SR",
"descrizione_ateco": "Produzione di software non connesso all'edizione",
"codice_ateco": "6201",
"data_inizio_attivita": "2013-10-20",
"bilanci": {"2017": {"data_chiusura_bilancio": "2017-12-31",
"fatturato": 1120176,
"utile": 2928
},
"2018": {"data_chiusura_bilancio": "2018-12-31",
"fatturato": 1325358,
"utile": 826
},
"2019": {"data_chiusura_bilancio": "2019-12-31",
"fatturato": 1799587,
"utile": 11309,
"dipendenti": 14,
"capitale_sociale": 10000
}
},
"gruppo_iva": {"partecipazione": false,
"piva_capogruppo": false,
"anagrafica_ok": true
},
"cessata": false,
"soci": [{"denominazione": "OPEN HOLDING S.R.L.",
"nome": null,
"cognome": null,
"cf_socio": "16935371001",
"quota": 100
}
]
},
"cap": "00143",
"codice_destinatario": "MJ1OYNU",
"id": "60b4f9c914e27c27d12a9d67",
"gps": {"coordinates": [12.47843,
41.8071
]
}
},
"success": true,
"message": "",
"error": null
}

Simple service to understand if a VAT number has ceased or not according to the Tax Office

Authorizations:

bearerAuth

path Parameters

piva_or_cf

required

string

Default: "<string>"

Example: 12485671007

VAT number or tax code

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Response samples

200
400
401
402

Content type

application/json

{"data": {"cessata": false
},
"success": true,
"message": "",
"error": null
}

From this service you can understand if a company is part of a VAT group and if the tax code is consistent with the VAT number taken as input

Authorizations:

bearerAuth

path Parameters

piva_or_cf

required

string

Default: "<string>"

Example: 12485671007

VAT number or tax code

query Parameters

cf	string Default: "<string>" Example: cf=12345678910 if a tax code is given, this service will return additional information about the relationship between the VAT group and the tax code

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Response samples

200
400
401
402

Content type

application/json

Example

{"data": {"gruppo_iva": {"partecipazione": false,
"piva_capogruppo": false,
"anagrafica_ok": true
}
},
"success": true,
"message": "",
"error": null
}

Starting from a VAT number it extracts the pec of the company

Authorizations:

bearerAuth

path Parameters

piva_or_cf

required

string

Default: "<string>"

Example: 12485671007

VAT number or tax code

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	integer

Response samples

200
204
400
402

Content type

application/json

{"data": {"pec": "altraviaservizi@legalmail.it"
},
"success": true,
"message": "",
"error": null
}

This service performs a search on the list of all the available companies with the given query

Authorizations:

bearerAuth

path Parameters

query

required

string

Default: "<string>"

Examples:

altravia* - Starts with
*altravia - Ends with
*altravia* - Contains

A search query; '*' can be used as a wildcard to search for strings that start, contain or end with the given query.

query Parameters

lat	number <double> [ -90 .. 90 ] Default: "<double>" Example: lat=13.5478 latitude
lng	number <double> [ -180 .. 180 ] Default: "<double>" Example: lng=42.859 longitude
radius	integer ( 0 .. 3000 ] Default: "<integer>" Example: radius=100 radius in meters

Responses

Response Schema: application/json

	Array of objects (Autocomplete) [ items ]
success	boolean
message	string
error	integer

Response samples

200
204
400
402
422

Content type

application/json

{"data": [{"id": "60b4a85585e34e615c569ef5",
"denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA"
}
],
"success": true,
"message": "",
"error": null
}

With this service you can see all the legal forms registered

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (FormaGiuridica) [ items ]
success	boolean
message	string
error	integer

Response samples

200

Content type

application/json

{"data": [{"codice_natura_giuridica": "AA",
"valore": "SOCIETA' IN ACCOMANDITA PER AZIONI"
},
{"codice_natura_giuridica": "AN",
"valore": "SOCIETA' CONSORTILE IN NOME COLLETTIVO"
},
{"codice_natura_giuridica": "EI",
"valore": "ENTE IMPRESA"
},
{"codice_natura_giuridica": "RR",
"valore": "SOCIETA' A RESPONSABILITA' LIMITATA A CAPITALE RIDOTTO"
}
],
"success": true,
"message": "",
"error": null
}

With this service you can see the value of the legal code passed as a parameter

Authorizations:

bearerAuth

path Parameters

codice_natura_giuridica

required

string

Default: "<string>"

Example: SP

legal code

Responses

Response Schema: application/json

	object (FormaGiuridica)
success	boolean
message	string
error	integer

Response samples

200
404

Content type

application/json

{"data": {"codice_natura_giuridica": "SP",
"valore": "SOCIETA' PER AZIONI"
},
"success": true,
"message": "",
"error": null
}

This call returns the list of all companies

Authorizations:

bearerAuth

query Parameters

lat	number <double> [ -90 .. 90 ] Default: "<double>" Example: lat=13.5478 latitude
lng	number <double> [ -180 .. 180 ] Default: "<double>" Example: lng=42.859 longitude
radius	integer ( 0 .. 3000 ] Default: "<integer>" Example: radius=100 radius in meters
	string or integer Example: skip=50 you can set a number of records you want to skip or the id of a company you want to start from
limit	integer Default: "<integer>" Example: limit=5000 is used to set the maximum number of results required
dry_run	integer Default: "<integer>" Enum: 1 0 Example: dry_run=0 simulates a request by returning only the number of records found

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	integer

Response samples

200
204
422

Content type

application/json

{"data": [{"id": "61f2c4d69fb8571d19235463"
},
{"id": "61f4r5y69fb8571d19237859"
},
{"id": "61f2f6t09fb8571d19237773"
}
],
"success": true,
"message": "",
"error": null
}

This call returns the list of all companies that have had updates after the time threshold passed via timestamp

Authorizations:

bearerAuth

path Parameters

timestamp

required

integer

Default: "<integer>"

Example: 1645021792

timestamp

query Parameters

lat	number <double> [ -90 .. 90 ] Default: "<double>" Example: lat=13.5478 latitude
lng	number <double> [ -180 .. 180 ] Default: "<double>" Example: lng=42.859 longitude
radius	integer ( 0 .. 3000 ] Default: "<integer>" Example: radius=100 radius in meters
	string or integer Example: skip=50 you can set a number of records you want to skip or the id of a company you want to start from
limit	integer Default: "<integer>" Example: limit=5000 is used to set the maximum number of results required
dry_run	integer Default: "<integer>" Enum: 1 0 Example: dry_run=0 simulates a request by returning only the number of records found

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	integer

Response samples

200
204
422

Content type

application/json

{"data": [{"id": "61f2c4d69fb8571d19235463"
},
{"id": "61f4r5y69fb8571d19237859"
}
],
"success": true,
"message": "",
"error": null
}

List of shareholders of a company

This method returns the list of shareholders of a company who have a share of the company greater than 10 percent

Authorizations:

bearerAuth

path Parameters

piva_cf_or_id

required

string

Default: "<string>"

Example: 12485671007

VAT number, tax code or company ID

Responses

Response Schema: application/json

	Array of objects (Soci) [ items ]
success	boolean
message	string
error	integer

Response samples

200
204
400
402
406

Content type

application/json

{"data": [{"denominazione": "OPEN HOLDING S.R.L.",
"nome": null,
"cognome": null,
"cf_socio": "16935371001",
"quota": 100
}
],
"success": true,
"message": "",
"error": null
}