BusinessRegistry

Retrieves the collection of BusinessRegistry resources.

SecurityBearer
Request
query Parameters
simpleSearch
string

Search by multiple fields at once: businessName, name, surname, businessVatNumberCode, businessFiscalCode

page
integer

The collection page number

Responses
200

BusinessRegistry collection response

get/business-registries
Request samples 
Response samples 
[
  • {
    }
]
Creates a BusinessRegistry resource.
SecurityBearer 
Request 
Request Body schema: 
The new BusinessRegistry resource


head_office_address_street
required
string
 
head_office_address_street_number
string
 
head_office_address_zip_code
required
string
 
head_office_address_city
required
string
 
head_office_address_province
string
 
head_office_address_country
required
string
ISO 3166-1 alpha-2 code


 
office_address_street
string
 
office_address_street_number
string
 
office_address_zip_code
string
 
office_address_city
string
 
office_address_province
string
 
office_address_country
string
ISO 3166-1 alpha-2 code


 
business_vat_number_country
string
ISO 3166-1 alpha-2 code


 
business_vat_number_code
string
 
business_fiscal_code
string
 
business_name
string
 
name
string
 
surname
string
 
title
string
 
cod_eori
string
 
professional_register
string
 
professional_register_province
string
 
professional_register_registration_number
string
 
professional_register_registration_date
string <date-time> 
ISO 8601:2004 (YYYY-MM-DD)


 
tax_regime
string
 
contact_phone
string
 
contact_fax
string
 
contact_email
rea_registration_office
string
2 chars Italian province


 
rea_registration_number
string
 
rea_registration_share_capital
string
 
rea_registration_sole_shareholder
string
SU sole shareholder, SM many shareholders


 
rea_registration_liquidation_status
string
LS in liquidation, LN not in liquidation


 
reference_administration
string
 
fiscal_representative_vat_number_country
string
ISO 3166-1 alpha-2 code


 
fiscal_representative_vat_number_code
string
 
fiscal_representative_fiscal_code
string
 
fiscal_representative_denomination
string
 
fiscal_representative_name
string
 
fiscal_representative_surname
string
 
fiscal_representative_title
string
 
fiscal_representative_cod_eori
string
 
recipient_code
string
 
Responses 
201
BusinessRegistry resource created


400
Invalid input


404
Resource not found


post/business-registries
Request samples 
{
  • "head_office_address_street": "string",
  • "head_office_address_street_number": "string",
  • "head_office_address_zip_code": "string",
  • "head_office_address_city": "string",
  • "head_office_address_province": "string",
  • "head_office_address_country": "string",
  • "office_address_street": "string",
  • "office_address_street_number": "string",
  • "office_address_zip_code": "string",
  • "office_address_city": "string",
  • "office_address_province": "string",
  • "office_address_country": "string",
  • "business_vat_number_country": "string",
  • "business_vat_number_code": "string",
  • "business_fiscal_code": "string",
  • "business_name": "string",
  • "name": "string",
  • "surname": "string",
  • "title": "string",
  • "cod_eori": "string",
  • "professional_register": "string",
  • "professional_register_province": "string",
  • "professional_register_registration_number": "string",
  • "professional_register_registration_date": "2019-08-24T14:15:22Z",
  • "tax_regime": "string",
  • "contact_phone": "string",
  • "contact_fax": "string",
  • "contact_email": "string",
  • "rea_registration_office": "string",
  • "rea_registration_number": "string",
  • "rea_registration_share_capital": "string",
  • "rea_registration_sole_shareholder": "string",
  • "rea_registration_liquidation_status": "string",
  • "reference_administration": "string",
  • "fiscal_representative_vat_number_country": "string",
  • "fiscal_representative_vat_number_code": "string",
  • "fiscal_representative_fiscal_code": "string",
  • "fiscal_representative_denomination": "string",
  • "fiscal_representative_name": "string",
  • "fiscal_representative_surname": "string",
  • "fiscal_representative_title": "string",
  • "fiscal_representative_cod_eori": "string",
  • "recipient_code": "string"
}
Response samples 
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "head_office_address_street": "string",
  • "head_office_address_street_number": "string",
  • "head_office_address_zip_code": "string",
  • "head_office_address_city": "string",
  • "head_office_address_province": "string",
  • "head_office_address_country": "string",
  • "office_address_street": "string",
  • "office_address_street_number": "string",
  • "office_address_zip_code": "string",
  • "office_address_city": "string",
  • "office_address_province": "string",
  • "office_address_country": "string",
  • "business_vat_number_country": "string",
  • "business_vat_number_code": "string",
  • "business_fiscal_code": "string",
  • "business_name": "string",
  • "name": "string",
  • "surname": "string",
  • "title": "string",
  • "cod_eori": "string",
  • "professional_register": "string",
  • "professional_register_province": "string",
  • "professional_register_registration_number": "string",
  • "professional_register_registration_date": "2019-08-24T14:15:22Z",
  • "tax_regime": "string",
  • "contact_phone": "string",
  • "contact_fax": "string",
  • "contact_email": "string",
  • "rea_registration_office": "string",
  • "rea_registration_number": "string",
  • "rea_registration_share_capital": "string",
  • "rea_registration_sole_shareholder": "string",
  • "rea_registration_liquidation_status": "string",
  • "reference_administration": "string",
  • "fiscal_representative_vat_number_country": "string",
  • "fiscal_representative_vat_number_code": "string",
  • "fiscal_representative_fiscal_code": "string",
  • "fiscal_representative_denomination": "string",
  • "fiscal_representative_name": "string",
  • "fiscal_representative_surname": "string",
  • "fiscal_representative_title": "string",
  • "fiscal_representative_cod_eori": "string",
  • "recipient_code": "string"
}
Retrieves a BusinessRegistry resource.
SecurityBearer 
Request 
path Parameters
id
required
string
 
Responses 
200
BusinessRegistry resource response


404
Resource not found


get/business-registries/{id}
Request samples 
Response samples 
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "head_office_address_street": "string",
  • "head_office_address_street_number": "string",
  • "head_office_address_zip_code": "string",
  • "head_office_address_city": "string",
  • "head_office_address_province": "string",
  • "head_office_address_country": "string",
  • "office_address_street": "string",
  • "office_address_street_number": "string",
  • "office_address_zip_code": "string",
  • "office_address_city": "string",
  • "office_address_province": "string",
  • "office_address_country": "string",
  • "business_vat_number_country": "string",
  • "business_vat_number_code": "string",
  • "business_fiscal_code": "string",
  • "business_name": "string",
  • "name": "string",
  • "surname": "string",
  • "title": "string",
  • "cod_eori": "string",
  • "professional_register": "string",
  • "professional_register_province": "string",
  • "professional_register_registration_number": "string",
  • "professional_register_registration_date": "2019-08-24T14:15:22Z",
  • "tax_regime": "string",
  • "contact_phone": "string",
  • "contact_fax": "string",
  • "contact_email": "string",
  • "rea_registration_office": "string",
  • "rea_registration_number": "string",
  • "rea_registration_share_capital": "string",
  • "rea_registration_sole_shareholder": "string",
  • "rea_registration_liquidation_status": "string",
  • "reference_administration": "string",
  • "fiscal_representative_vat_number_country": "string",
  • "fiscal_representative_vat_number_code": "string",
  • "fiscal_representative_fiscal_code": "string",
  • "fiscal_representative_denomination": "string",
  • "fiscal_representative_name": "string",
  • "fiscal_representative_surname": "string",
  • "fiscal_representative_title": "string",
  • "fiscal_representative_cod_eori": "string",
  • "recipient_code": "string"
}
Removes the BusinessRegistry resource.
SecurityBearer 
Request 
path Parameters
id
required
string
 
Responses 
204
BusinessRegistry resource deleted


404
Resource not found


delete/business-registries/{id}
Request samples 
Replaces the BusinessRegistry resource.
SecurityBearer 
Request 
path Parameters
id
required
string
 
Request Body schema: 
The updated BusinessRegistry resource


head_office_address_street
required
string
 
head_office_address_street_number
string
 
head_office_address_zip_code
required
string
 
head_office_address_city
required
string
 
head_office_address_province
string
 
head_office_address_country
required
string
ISO 3166-1 alpha-2 code


 
office_address_street
string
 
office_address_street_number
string
 
office_address_zip_code
string
 
office_address_city
string
 
office_address_province
string
 
office_address_country
string
ISO 3166-1 alpha-2 code


 
business_vat_number_country
string
ISO 3166-1 alpha-2 code


 
business_vat_number_code
string
 
business_fiscal_code
string
 
business_name
string
 
name
string
 
surname
string
 
title
string
 
cod_eori
string
 
professional_register
string
 
professional_register_province
string
 
professional_register_registration_number
string
 
professional_register_registration_date
string <date-time> 
ISO 8601:2004 (YYYY-MM-DD)


 
tax_regime
string
 
contact_phone
string
 
contact_fax
string
 
contact_email
rea_registration_office
string
2 chars Italian province


 
rea_registration_number
string
 
rea_registration_share_capital
string
 
rea_registration_sole_shareholder
string
SU sole shareholder, SM many shareholders


 
rea_registration_liquidation_status
string
LS in liquidation, LN not in liquidation


 
reference_administration
string
 
fiscal_representative_vat_number_country
string
ISO 3166-1 alpha-2 code


 
fiscal_representative_vat_number_code
string
 
fiscal_representative_fiscal_code
string
 
fiscal_representative_denomination
string
 
fiscal_representative_name
string
 
fiscal_representative_surname
string
 
fiscal_representative_title
string
 
fiscal_representative_cod_eori
string
 
recipient_code
string
 
Responses 
200
BusinessRegistry resource updated


400
Invalid input


404
Resource not found


put/business-registries/{id}
Request samples 
{
  • "head_office_address_street": "string",
  • "head_office_address_street_number": "string",
  • "head_office_address_zip_code": "string",
  • "head_office_address_city": "string",
  • "head_office_address_province": "string",
  • "head_office_address_country": "string",
  • "office_address_street": "string",
  • "office_address_street_number": "string",
  • "office_address_zip_code": "string",
  • "office_address_city": "string",
  • "office_address_province": "string",
  • "office_address_country": "string",
  • "business_vat_number_country": "string",
  • "business_vat_number_code": "string",
  • "business_fiscal_code": "string",
  • "business_name": "string",
  • "name": "string",
  • "surname": "string",
  • "title": "string",
  • "cod_eori": "string",
  • "professional_register": "string",
  • "professional_register_province": "string",
  • "professional_register_registration_number": "string",
  • "professional_register_registration_date": "2019-08-24T14:15:22Z",
  • "tax_regime": "string",
  • "contact_phone": "string",
  • "contact_fax": "string",
  • "contact_email": "string",
  • "rea_registration_office": "string",
  • "rea_registration_number": "string",
  • "rea_registration_share_capital": "string",
  • "rea_registration_sole_shareholder": "string",
  • "rea_registration_liquidation_status": "string",
  • "reference_administration": "string",
  • "fiscal_representative_vat_number_country": "string",
  • "fiscal_representative_vat_number_code": "string",
  • "fiscal_representative_fiscal_code": "string",
  • "fiscal_representative_denomination": "string",
  • "fiscal_representative_name": "string",
  • "fiscal_representative_surname": "string",
  • "fiscal_representative_title": "string",
  • "fiscal_representative_cod_eori": "string",
  • "recipient_code": "string"
}
Response samples 
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "head_office_address_street": "string",
  • "head_office_address_street_number": "string",
  • "head_office_address_zip_code": "string",
  • "head_office_address_city": "string",
  • "head_office_address_province": "string",
  • "head_office_address_country": "string",
  • "office_address_street": "string",
  • "office_address_street_number": "string",
  • "office_address_zip_code": "string",
  • "office_address_city": "string",
  • "office_address_province": "string",
  • "office_address_country": "string",
  • "business_vat_number_country": "string",
  • "business_vat_number_code": "string",
  • "business_fiscal_code": "string",
  • "business_name": "string",
  • "name": "string",
  • "surname": "string",
  • "title": "string",
  • "cod_eori": "string",
  • "professional_register": "string",
  • "professional_register_province": "string",
  • "professional_register_registration_number": "string",
  • "professional_register_registration_date": "2019-08-24T14:15:22Z",
  • "tax_regime": "string",
  • "contact_phone": "string",
  • "contact_fax": "string",
  • "contact_email": "string",
  • "rea_registration_office": "string",
  • "rea_registration_number": "string",
  • "rea_registration_share_capital": "string",
  • "rea_registration_sole_shareholder": "string",
  • "rea_registration_liquidation_status": "string",
  • "reference_administration": "string",
  • "fiscal_representative_vat_number_country": "string",
  • "fiscal_representative_vat_number_code": "string",
  • "fiscal_representative_fiscal_code": "string",
  • "fiscal_representative_denomination": "string",
  • "fiscal_representative_name": "string",
  • "fiscal_representative_surname": "string",
  • "fiscal_representative_title": "string",
  • "fiscal_representative_cod_eori": "string",
  • "recipient_code": "string"
}