List companies

List companies in registries based on search phrase

Input

User needs to provide search phrase and search mode. The search phrase should be detailed enough to find a specific company, in the case of generic search phrases, an error is returned.

Attribute	Type	Description
search	String	Search phrase (at least 3 characters)
searchMode	String	Search mode: ALL_KEYWORDS ANY_KEYWORD PATTERN - when provided, search phrase should contains % symbol which includes any number of characters following or preceding a given search phrase eg. %ferrari%
tradeBoards	String	Comma separated values which symbols of Italian Chambers of Commerce that narrow searching scope eg. MI,BR,PC (optional)

Output

ListCompaniesRI

Contains details about individual companies registered in the Registro Imprese (RI)

Attribute	Type	Description
companies	Array	An array of objects containing detailed information about individual companies.

Companies

An array of objects containing detailed information about individual companies.

Attribute	Type	Description
enterpriseNumber	Number	Sequence number
companyDetails	Object	Contains detailed information about a specific company.

CompanyDetails

Contains detailed information about a specific company.

Attribute	Type	Description
chamberOfCommerce	String	The chamber of commerce where the company is registered.
chamberDescription	String	Description of the chamber of commerce.
rea	String	Registro delle Imprese (REA) number.
name	String	The name of the company.
provinceCode	String	The province code where the company is located.
provinceDescription	String	Description of the province where the company is located.
taxCode	String	The tax code of the company.
vatNumber	String	The VAT number of the company.
legalStatus	String	The legal status code of the company.
legalStatusDescription	String	Description of the legal status of the company.
source	String	The source of registration of the company.
sourceDescription	String	Description of the registration source.
activityStatus	String	The activity status code of the company.
activityStatusDescription	String	Description of the activity status of the company.
registeredActivityStatus	String	The registered activity status code of the company.
registeredActivityStatusDescription	String	Description of the registered activity status of the company.
declaredActivity	String	The declared activity of the company.
atecoClassification	Array	An array containing ATECO classification details.
headquartersAddress	Object	Contains details about the headquarters address of the company.
certifiedMailAddress	String	The certified mail address of the company.

AtecoClassification

Contains ATECO classification details.

Attribute	Type	Description
codingCode	String	The ATECO coding code.
codingDescription	String	Description of the ATECO coding.
activityCode	String	The activity code.
activityDescription	String	Description of the activity.

HeadquartersAddress

Contains details about the headquarters address of the company.

Attribute	Type	Description
provinceCode	String	The province code of the headquarters address.
provinceDescription	String	Description of the province of the headquarters address.
cityCode	String	The city code of the headquarters address.
cityDescription	String	Description of the city of the headquarters address.
toponymCode	String	The toponym code of the headquarters address.
toponymDescription	String	Description of the toponym of the headquarters address.
street	String	The street name of the headquarters address.
streetNumber	String	The street number of the headquarters address.
postalCode	String	The postal code of the headquarters address.
fraction	String	Additional information about the headquarters address fraction, if available.

{
    "infocamere": {
        "listCompaniesRI": {
            "companies": [
                {
                    "enterpriseNumber": 3,
                    "companyDetails": {
                        "chamberOfCommerce": "BG",
                        "chamberDescription": "BERGAMO",
                        "rea": "134667",
                        "name": "BREMBO S.P.A.",
                        "provinceCode": "BG",
                        "provinceDescription": "BERGAMO",
                        "taxCode": "00222620163",
                        "vatNumber": "00222620163",
                        "legalStatus": "SP",
                        "legalStatusDescription": "SOCIETA' PER AZIONI",
                        "source": "RI",
                        "sourceDescription": "Registro Imprese",
                        "activityStatus": "R",
                        "activityStatusDescription": "Registrata",
                        "registeredActivityStatus": "A",
                        "registeredActivityStatusDescription": "Attiva",
                        "declaredActivity": "FABBRICAZIONE DI ALTRE PARTI ED ACCESSORI PER AUTOVEICOLI E LORO MOTORI NCA",
                        "atecoClassification": [
                            {
                                "codingCode": "07",
                                "codingDescription": "Classificazione ATECO RI 2007",
                                "activityCode": "29.32.09",
                                "activityDescription": "Fabbricazione di altre parti ed accessori per autoveicoli e loro motori nca"
                            }
                        ],
                        "headquartersAddress": {
                            "provinceCode": "BG",
                            "provinceDescription": "BERGAMO",
                            "cityCode": "BG089",
                            "cityDescription": "CURNO",
                            "toponymCode": "VIA",
                            "toponymDescription": "VIA",
                            "street": "BREMBO",
                            "streetNumber": "25",
                            "postalCode": "24035"
                        },
                        "certifiedMailAddress": "[e-mail]"
                    }
                }
            ]
        }
    }
}