Yay.com loading

Loading

Call us on (917) 9001 YAY

Login to Yay.com

Did you know we also sell domains?

Add domain registration to your VoIP service and manage your business in one location, anytime!

  • $26.19 / year

    .co

  • $9.79 / year

    .com

  • $11.99 / year

    .net

  • $8.19 / year

    .shop

  • $8.59 / year

    .us

  • $1.19 / year

    .xyz

View all domain pricing

Domain Management

API Access

Build custom apps using our JSON API

1st month FREE
Become a Reseller

Host Names

Domain hosts describe nameservers available on the specified domain name.

Become a Reseller

Filter:

  • All
  • GET
  • POST
  • PUT
  • DELETE
  • DELETE
  • Chargeable *

* You will be charged every time this command is run.

  • GET/dom/host

    Gets all domain hosts

    Back to top

    Request Details

    Response Details

    Request Details

    This command has no URL/Query String parameters

    Response Details

    200 Response

    {
        "result" : [
            {
                "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
                "host_name" : "ns1",
                "ip_addresses" : [
                    "8.8.8.8",
                    "8.8.4.4"
                ],
                "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                "created_on" : "2018-05-27",
                "updated_on" : "2018-05-27"
            }
        ],
        "status_code" : 200,
        "status_message" : "OK"
    }
  • GET/dom/host/{uuid}

    Gets a specific domain hosts

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the domain host to be queried

    Response Details

    200 Response

    {
        "result" : {
            "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
            "host_name" : "ns1",
            "ip_addresses" : [
                "8.8.8.8",
                "8.8.4.4"
            ],
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
            "created_on" : "2018-05-27",
            "updated_on" : "2018-05-27"
        },
        "status_code" : 200,
        "status_message" : "OK"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
  • POST/dom/host

    Creates a new host

    Back to top

    Request Details

    Response Details

    Request Details

    This command has no URL/Query String parameters

    POST body

    • Name

    • Type

    • Required

      • domain_uuid

      • String

      • True

      The UUID of the domain this host name is applied to

      • host_name

      • String

      • True

      The name of this domains host name

      • ip_addresses

      • Array of String

      • True

      A list of IP addresses to apply to this host name

    JSON all-fields example:

    {
        "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
        "host_name" : "ns1",
        "ip_addresses" : [
            "8.8.8.8",
            "8.8.4.4"
        ]
    }

    Response Details

    201 Response

    {
        "result" : {
            "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
            "host_name" : "ns1",
            "ip_addresses" : [
                "8.8.8.8",
                "8.8.4.4"
            ],
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
            "created_on" : "2018-05-27"
        },
        "status_code" : 201,
        "status_message" : "Created"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
  • PUT/dom/host/{uuid}

    Updates the specified host

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the domain host to be updated

    PUT body

    • Name

    • Type

    • Required

      • domain_uuid

      • String

      • True

      The UUID of the domain this host name is applied to

      • host_name

      • String

      • True

      The name of this domains host name

      • ip_addresses

      • Array of String

      • True

      A list of IP addresses to apply to this host name

    JSON all-fields example:

    {
        "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
        "host_name" : "ns1",
        "ip_addresses" : [
            "8.8.8.8",
            "8.8.4.4"
        ]
    }

    Response Details

    200 Response

    {
        "result" : {
            "domain_uuid" : "a7ba3588-dbe0-4972-bfac-3da598607583",
            "host_name" : "ns1",
            "ip_addresses" : [
                "8.8.8.8",
                "8.8.4.4"
            ],
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
            "created_on" : "2018-05-27",
            "updated_on" : "2018-05-27"
        },
        "status_code" : 200,
        "status_message" : "OK"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
  • DELETE/dom/host/{uuid}

    Deletes the specified host

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the domain host to be deleted

    Response Details

    204 Response

    {
        "result" : {},
        "status_code" : 204,
        "status_message" : "No Content"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }