Endpoint

/v1/dns/resolve-ips-to-names

POST

Resolve a list of IP addresses to canonical hostnames.

Parameters

This resource has no parameters.

Request

Schema

{
  "type": "array",
  "items": {
    "type": "string"
  }
}

Response

Codes

Code Description
200 Return value on success

Schema

{
  "type": "array",
  "items": {
    "description": "api_resolved_ip",
    "type": "object",
    "properties": {
      "ip_address": {
        "description": "The IP address which was resolved",
        "type": "string"
      },
      "hostname": {
        "description": "The resolved name of the IP address",
        "type": "string"
      },
      "result": {
        "type": "string",
        "enum": [
          "OK",
          "ERROR",
          "NOT_FOUND",
          "TIMEOUT"
        ],
        "description": "The status of the resolution:\n * `ERROR` - DNS_RESOLUTION_ERROR,\n * `NOT_FOUND` - DNS_RESOLUTION_NOT_FOUND,\n * `OK` - DNS_RESOLUTION_OK,\n * `TIMEOUT` - DNS_RESOLUTION_TIMEOUT"
      }
    }
  }
}