Run with Postman
Documentation Powered by Redocly

Domains

URL: https://openapi.it/en/support License: Terms of Service

This web service allows you to purchase and manage .it domains.

First time here? Generate a new access token

Contact

Calls for checking, managing and recording contacts

List of your contacts

This method lets you see the list of contacts associated with your domains

Authorizations:
bearerAuth

    Responses

    Response Schema: application/json
    data
    Array of strings
    success
    boolean
    message
    string
    error
    integer

    Request samples 

    CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/contact");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

    Response samples

    Content type
    application/json
    {
    • "data": [
      ],
    • "success": true,
    • "message": "",
    • "error": null
    }

    Create 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. If you want to create a 'registrant' contact, 'nationalitycode', 'entitytype' and 'regcode' are mandatory.

    Authorizations:
    bearerAuth
      Request Body schema: application/json
      name
      required
      string
      Default: "<string>"

      Contact name

      org
      required
      string
      Default: "<string>"

      Contact organization

      street
      required
      string
      Default: "<string>"

      Contact address

      city
      required
      string
      Default: "<string>"

      Contact city

      province
      required
      string
      Default: "<string>"

      Contact province

      postalcode
      required
      string
      Default: "<string>"

      Contact postal code

      countrycode
      required
      string
      Default: "<string>"

      Contact country code

      voice
      required
      string
      Default: "<string>"

      Contact telephone number; only this international format accepted:'+39.3502285745'

      email
      required
      string
      Default: "<string>"

      Contact email

      nationalitycode
      string
      Default: "<string>"

      Contact nationality code

      entitytype
      integer
      Default: "<integer>"
      Enum: 0 1 2 3 4 5 6 7

      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
      Default: "<string>"

      Tax code or VAT number

      Responses

      Response Schema: application/json
      object
      success
      boolean
      message
      string
      error
      integer

      Request samples

      Content type
      application/json
      {
      • "name": "Jane Doe",
      • "org": "Jane Doe",
      • "street": "Via xxx 2",
      • "city": "Terni",
      • "province": "TR",
      • "postalcode": "05100",
      • "countrycode": "IT",
      • "voice": "+39.349xxxxxxx",
      • "email": "j.doe@altravia.com"
      }

      Response samples

      Content type
      application/json
      {
      • "data": {
        },
      • "message": "Greeting OK. Login OK. Create contact 'AV-982654609' created. Logout OK.",
      • "success": true,
      • "error": null
      }

      Single contact

      This method allows you to see the single contact related to the parameter passed in the path

      Authorizations:
      bearerAuth
        path Parameters
        handle
        required
        string
        Default: "<string>"
        Example: LS7743

        Contact Id

        Responses

        Response Schema: application/json
        object (Contact_Object)
        success
        boolean
        message
        string
        error
        integer

        Request samples 

        CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/contact/%7Bhandle%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

        Response samples

        Content type
        application/json
        {
        • "data": {
          },
        • "success": true,
        • "message": "",
        • "error": null
        }