{"type":"api","title":"Get WHOIS Information for Nameserver","meta":{"id":"/apps/pubhub/media/legacy-umbrella-api/bf58de618cbb72dda8f39b0414ce94c0a15cd467/f963d12c-70c5-3340-bb7c-d5cff60c643a","info":{"title":"Investigate API","description":"Umbrella Investigate API","version":"1.1.4","contact":{"name":"Cloud Security Developer Community"}},"security":[{"bearerAuth":[]}],"tags":[{"name":"Domain Status and Categorization"},{"name":"Domain Volume"},{"name":"Co-occurrences for a Domain"},{"name":"Passive DNS"},{"name":"Tagging Timeline"},{"name":"Subdomains for a Domain"},{"name":"Related Domains for a Domain"},{"name":"Security Information for a Domain"},{"name":"AS Information for a Domain"},{"name":"WHOIS Information for a Domain"},{"name":"Umbrella Popularity List-Top Million Domains"},{"name":"Search Domain"},{"name":"Cisco Secure Malware Analytics Integration"}],"x-parser-conf":{"overview":{"markdownPath":"investigate/investigate-explorer-overview.md"}},"openapi":"3.0.0","servers":[{"url":"https://investigate.api.umbrella.com"}],"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"spec":{"summary":"Get WHOIS Information for Nameserver","operationId":"getWhoisNameserver","tags":["WHOIS Information for a Domain"],"description":"Get WHOIS information for the nameserver.\nAs a nameserver can potentially register hundreds or thousands of domains,\nthe server limits the number of results to 500.","parameters":[{"name":"nameserver","in":"path","required":true,"description":"The nameserver's domain name.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Specify the number of records to return from the collection.\nThe default limit is 500.","schema":{"type":"integer","default":500}},{"name":"offset","in":"query","required":false,"description":"A number that represents an index into the collection. By default, the offset is 0 (the first record).","schema":{"type":"integer"},"$$ref":"#/components/parameters/offsetParam"},{"name":"sortField","in":"query","required":false,"description":"Valid values are: 'created', 'updated', 'expires', or 'domainname'.","schema":{"type":"string"},"$$ref":"#/components/parameters/sortFieldParam"}],"responses":{"200":{"description":"Everything worked as expected.","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"integer"},"moreDataAvailable":{"type":"boolean"},"limit":{"type":"integer"},"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"current":{"type":"boolean"}},"$$ref":"#/components/schemas/WhoisEmailsAndNameservers"}}}},"example":{"ns2.google.com":null,"totalResults":500,"moreDataAvailable":true,"limit":500,"domains":[{"domain":"46645.biz","current":true},{"domain":"800google411.net","current":true},{"domain":"zagatnyc.com","current":true},{"domain":"zavers.com","current":true}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/500Error"}},"__originalOperationId":"getWhoisNameserver","security":[{"bearerAuth":[]}],"method":"get","path":"/whois/nameservers/{nameserver}"}}