{"type":"api","title":"Get Subdomains for Domain","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":{"operationId":"getSubDomains","tags":["Subdomains for a Domain"],"description":"Get subdomains of a given domain. If there is no subdomain for the domain,\nUmbrella Investigate returns an empty array.\n","summary":"Get Subdomains for Domain","parameters":[{"name":"domain","in":"path","required":true,"description":"A domain name.","schema":{"type":"string"},"example":"cisco.com"},{"name":"limit","in":"query","required":false,"description":"The number of records to return in the collection.\nThe default limit is 20 records. The maximum number of records is 100.","example":50,"schema":{"type":"integer"}},{"name":"offsetName","in":"query","required":false,"description":"Specify the subdomain to filter the collection. For example: https://investigate.api.umbrella.com/subdomains/cisco.com?offsetName=api.cisco.com\nThe default value is the target domain.","schema":{"type":"string"},"example":"api.cisco.com"}],"responses":{"200":{"description":"Success. Everything worked as expected.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the subdomain."},"securityCategories":{"type":"array","items":{"type":"string","description":"The list of security categories that are tagged on this subdomain.\nUmbrella returns an empty array if no security categories match the subdomain."}},"firstSeen":{"type":"integer","format":"int64","description":"The first time Umbrella related the domain for the resource record.\nThe date and time is specified in milliseconds elapsed since the epoch (Unix time).","example":1615427410}}},"$$ref":"#/components/schemas/Subdomains"},"example":[{"securityCategories":["Cryptomining"],"firstSeen":1612088333,"name":"api.c3pool.com"},{"securityCategories":["Cryptomining"],"firstSeen":1615427410,"name":"asia.c3pool.com"}]}}}},"__originalOperationId":"getSubDomains","security":[{"bearerAuth":[]}],"method":"get","path":"/subdomains/{domain}"}}