• Domains
  • POST Contact

New contact

This method allows you to register a new contact in the system, which you will then need to associate with the new domains to be purchased.


Production environment:

  • https://domains.altravia.com/contact

Testing environment

  • https://test.domains.altravia.com/contact


Property name Type Required Description
name string yes Contact name.
org string yes Contact organization.
street string yes Contact address.
city string yes Contact city.
province string yes Contact province.
postalcode string yes Contact postal code.
countrycode string yes Contact country code.
voice string yes Contact telephone number; only this international format accepted:'+39.3502285745'.
email string yes Contact email.
nationalitycode string no* Contact nationality code.
entitytype int no* Contact entity type:
- 0: non-registering contact.
- 1: natural persons.
- 2: companies, sole proprietorships.
- 3: freelancers.
- 4: non-profit organizations.
- 5: public entities.
- 6: other subjects.
- 7: foreign subjects.
regcode string no* Tax code or VAT number.

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
data array Empty if the call is successful.
message string It contains a message that can be shown by the user.
success boolean True or false.
error int Present only if the API call fails, it contains an error code.