jobs

Get discovered subdomains

Get subdomains discovered for the domain in this job.

Triggers subdomain enumeration on first call (CT SAN extraction + DNS brute-force). Subsequent calls within the cache TTL return cached results.

Returns 404 if the job does not exist, 409 if the analysis is still in progress.

get/jobs/{job_id}/subdomains

Request

  • Base URL: https://api.whoisgeni.us (the document declares no server; this is the origin it was published from)
  • URL: https://api.whoisgeni.us/jobs/{job_id}/subdomains
  • Auth: none declared

Path parameters

job_idstring required

Headers

X-API-Keystring nullable

Response

Successful Response

metaobject nullable

Example response

{
  "data": {
    "cached": false,
    "domain": "example.com",
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "sources_used": [
      "ct_san",
      "dns_brute"
    ],
    "subdomains": [
      {
        "source": "ct_san",
        "subdomain": "mail.example.com"
      },
      {
        "source": "dns_brute",
        "subdomain": "api.example.com"
      }
    ],
    "total": 2,
    "wildcard_detected": false
  },
  "error": {
    "code": "JOB_NOT_FOUND",
    "message": "No job found with the given ID."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.