====================
Get Domain Info
====================

To get information about domain, you must sed ``GET`` Request to https://globalr.com/api/domain/{domainName}, where {domainName}-is that domain which one you want check.

For example: (you can find  sendToGlobalR() function in http://globalr.com/doc/api/overview.html#simple-request-example-in-php);

.. code-block:: php

    <?php
    $params = [];
    $resault = sendToGlobalR($params, 'GET', '/domain/checkfreedomain.am', 'xXGsvO26ntTHTESTKEYSOICKu8nOvMzKKiwg');

Example responce

.. code-block:: json

    {
      "domain": "checkfreedomain.am",
      "massage": "This domain can be registered",
      "available": true,
      "whois": "%\n%AM TLD whois server #1\n%\n\nNo match\n\n",
      "prices": [
        {
          "price": "16.80",
          "year": "1"
        },
        {
          "price": "33.60",
          "year": "2"
        },
        {
          "price": "50.40",
          "year": "3"
        },
        {
          "price": "67.20",
          "year": "4"
        },
        {
          "price": "84.00",
          "year": "5"
        }
      ]
    }

There is posible 4 type of response

+ domain is invalid
+ domain is free for registration
+ domain has unsupported extension
+ domain Name already registered, but not by you
+ domain Name already registered, and owned by you

If domain owned by you, full information will be given to you, for example:

.. code-block:: json

    {
      "domain": "example.am",
      "massage": "This domain is busy and unavailable for registration",
      "info": {
        "name": "example.am",
        "created_at": "2016-08-10 10:38:58",
        "expiration_date": "2017-08-11 00:00:00",
        "status_id": "2",
        "registered_at": "2016-08-11 00:00:00",
        "exp_days": 204,
        "contacts": {
          "admin": {
            "entity": "person",
            "name": "Jone",
            "last_name": "Smith",
            "organisation": "",
            "email": "jhone@example.com",
            "phone": "+5555555555",
            "mobile_phone": null,
            "fax": null,
            "country_code": "AM",
            "city": "Yerevan",
            "state": null,
            "address1": "Example street 8\/33",
            "address2": null,
            "zip": "0010"
          },
          "owner": {
            "entity": "person",
            "name": "Jone",
            "last_name": "Smith",
            "organisation": "",
            "email": "jhone@example.com",
            "phone": "+5555555555",
            "mobile_phone": null,
            "fax": null,
            "country_code": "AM",
            "city": "Yerevan",
            "state": null,
            "address1": "Example street 8\/33",
            "address2": null,
            "zip": "0010"
          },
          "billing": {
            "entity": "person",
            "name": "Jone",
            "last_name": "Smith",
            "organisation": "",
            "email": "jhone@example.com",
            "phone": "+5555555555",
            "mobile_phone": null,
            "fax": null,
            "country_code": "AM",
            "city": "Yerevan",
            "state": null,
            "address1": "Example street 8\/33",
            "address2": null,
            "zip": "0010"
          },
          "technical": {
            "entity": "person",
            "name": "Jone",
            "last_name": "Smith",
            "organisation": "",
            "email": "jhone@example.com",
            "phone": "+5555555555",
            "mobile_phone": null,
            "fax": null,
            "country_code": "AM",
            "city": "Yerevan",
            "state": null,
            "address1": "Example street 8\/33",
            "address2": null,
            "zip": "0010"
          }
        },
        "ns": [
          {
            "name": "ns1.globalr.com",
            "ip": ""
          },
          {
            "name": "ns2.globalr.com",
            "ip": ""
          },
        ]
      },
      "available": false,
      "whois": "%\n%AM TLD whois server #1\n%\n\n   Domain name: example.am\n   ..... Full whois info ......",
      "prices": [
        {
          "price": "19.90",
          "year": "1"
        },
        {
          "price": "39.80",
          "year": "2"
        },
        {
          "price": "59.70",
          "year": "3"
        },
        {
          "price": "79.60",
          "year": "4"
        },
        {
          "price": "99.50",
          "year": "5"
        }
      ]
    }