• Domains
  • POST Domain

New domain

This method allows you to buy a new domain or transfer an existing one.


Production environment:

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

Testing environment

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


Property name Type Required Description
domain string yes* Domain name.
authinfo string yes* Domain authorization code.
registrant string yes* Registrant identifier.
admin string yes* Admin identifier.
tech array yes* Tech identifier list.
dns array yes* List of dns to add.

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.
price double Domain purchase price.
success boolean True or false.
error int Present only if the API call fails, it contains an error code.