Addresses

The address is usually part of a document.

Address extraction

In our extraction process, we rely on our own internal address management proxy to improve our extraction rates. To give you additional matching measures, we provide an address_id, which is our internal reference to that address.

The address changed!

In some cases, we might update the address if a company moves to a new location, in this case you will get the updated address while it still has the original address_id. By providing the same address_id, you are able to update your address as well, if that is convenient for you.

Validating address data

In some cases, we validate the address against country specific company registries. In those cases, you might also get a company_id and/or a vat_id as part of your address record.

Currently supported countries: Switzerland

A different address has been returned

If we find a vat id or company id on the document and it belongs to a company register we support, then the returned address will always be the main address of the company as stated in the register.

Company vs private address

We don’t explicitly indicate if it is a company or a private address, but we do only fill in either value company_name or contact_person_name accordingly. Based on that, if no company_name is given, we expect it to be a private address.

Address attributes

All fields (including address_id) are optional, none of these is required and will only be provided if available. Addresses are in general readonly and will not be specified any further.

address_id Integer Internal Parashift Address ID
company_name String Name of the company
contact_person_name String Name of the contact person
street String Name of the street
house_number String House number
post_office_box String Post office box
postal_code String Postal code
city_name String Name of the city
country_code String 2 letter ISO Code of the country