• Vat
  • Get Company

Company information

This method allows to extract information on a company starting from its VAT number.


  • Production environment: https://vat.altravia.com/companies/"vat"
  • Testing environment: https://test.vat.altravia.com/companies/"vat"


Request examples



Response Format

If successful, the response header HTTP status code will be 200 OK and the request will be answered.

If you try to get a request without authorization, you will receive an error 401 Unauthorized.

Additionally you should also handle the 400 Bad request status. For more info on HTTP status handling see dedicated section in Integration best practices page.

Request Response

Parameter Type Description
_id object Object id.
denominazione string Name of the owner of the VAT number.
codiceFiscale string Tax code of the owner of the VAT number.
idIva IvaResponseDetails Contains information on the VAT number.
indirizzo IndirizzoResponseDetails Contains specific information on the address of the company.
codiceDestinatario string Electronic address for electronic invoicing.
exists boolean Indicates the existence or not of the VAT number.
success boolean True or false.
message string Contains error or success messages.
error int Contains the encoding of the error or NULL if successful.

Iva Response Details

Parameter Type Description
codicePaese string Country code.
partitaIva string Vat.

Indirizzo Response Details

Parameter Type Description
indirizzo string Company address.
cap string Company postal code.
comune string Company city.
provincia string Province of the company.