Error Codes

Some fields carry their own error object — a code enum plus a human-readable message — separate from whether the GraphQL request itself succeeded. A pillar's error is populated when that specific check (SSL, DNS, WHOIS, etc.) couldn't complete; the rest of the response is still valid, and the request returns normally.

query {
  getSite(domain: "acme.io") {
    ssl {
      error {
        code
        message
      }
      payload {
        expirationDate
      }
    }
  }
}

If error is null, the pillar ran successfully — check payload instead.

SSL

SslErrorCode — site.ssl.error.code, and on the SSL incident types.

enum SslErrorCode {
  SSL_CHAIN_VERIFICATION_FAILED
  SSL_UNEXPECTED_ERROR
  SSL_PEER_CERT_MISMATCH
  SSL_PEER_UNREACHABLE
}

Certificates

CertificateErrorCode — site.certificate.error.code. See Site: Certificates.

enum CertificateErrorCode {
  CERTIFICATE_UNEXPECTED_ERROR
}

Domain

DomainErrorCode — site.whois.error.code, and on the domain incident types.

enum DomainErrorCode {
  WHOIS_DOMAIN_NOT_FOUND
  WHOIS_DOMAIN_UNEXPECTED_ERROR
  WHOIS_DOMAIN_SERVER_NOT_FOUND
  WHOIS_DOMAIN_SERVER_NOT_WORKING
  RDAP_DOMAIN_NOT_FOUND
  RDAP_DOMAIN_SERVER_NOT_FOUND
  RDAP_DOMAIN_INVALID_RESPONSE
  RDAP_DOMAIN_QUERY_FAILED
  RDAP_DOMAIN_SERVER_NOT_WORKING
  DOMAIN_QUERY_FAILED
}

DNS

Two levels: DNSRequestErrorCode covers the pillar-level DNS lookup itself (site.dns.error.code); DnsErrorCode covers parsing issues on individual derived records (SPF, DMARC, BIMI, TLS-RPT, MTA-STS) within site.dns.payload.

enum DNSRequestErrorCode {
  DNS_REQUEST_DOMAIN_NOT_FOUND
  DNS_REQUEST_NO_NAMESERVERS
  DNS_REQUEST_NO_ANSWER
  DNS_REQUEST_TIMEOUT
  DNS_REQUEST_UNEXPECTED_ERROR
}

enum DnsErrorCode {
  DNS_MULTIPLE_DMARC_ERROR
  DNS_INVALID_SPF_ERROR
  DNS_MULTIPLE_SPF_ERROR
  DNS_MULTIPLE_BIMI_ERROR
  DNS_MULTIPLE_TLS_RPT_ERROR
  DNS_INVALID_TLS_RPT_ERROR
  DNS_MULTIPLE_MTA_STS_ERROR
  DNS_INVALID_MTA_STS_ERROR
  DNS_RECORD_UNEXPECTED_ERROR
}

Main Page

MainPageErrorCode — site.mainPage.error.code.

enum MainPageErrorCode {
  MAIN_PAGE_UNEXPECTED_ERROR
  MAIN_PAGE_DOMAIN_MISMATCH
  MAIN_PAGE_REDIRECT_LIMIT_EXCEEDED
  MAIN_PAGE_CRAWLER_UNSUPPORTED_SCHEMA
  MAIN_PAGE_INVALID_URL
}

Robots.txt

RobotsTxtErrorCode — site.robotsTxt.error.code.

enum RobotsTxtErrorCode {
  ROBOTS_TXT_NOT_FOUND
  ROBOTS_TXT_INVALID_SIZE
  ROBOTS_TXT_INVALID_FORMAT
  ROBOTS_TXT_UNEXPECTED_ERROR
}

Sitemap

Two levels: SitemapDiscoveryErrorCode covers discovering a domain's sitemap(s) (site.sitemap.error.code); SitemapErrorCode covers individual sitemap files/entries within findSiteSitemap / findSiteSitemapLink. See Site: Sitemap.

enum SitemapDiscoveryErrorCode {
  SITEMAP_ROBOTS_TXT_UNAVAILABLE
  SITEMAP_DIRECTIVE_NOT_FOUND
  SITEMAP_DISCOVERY_UNREACHABLE
}

enum SitemapErrorCode {
  SITEMAP_NOT_FOUND
  SITEMAP_TOO_LARGE
  SITEMAP_INVALID_FORMAT
  SITEMAP_UNEXPECTED_ERROR
  SITEMAP_FILE_LIMIT_REACHED
  SITEMAP_LINK_LIMIT_REACHED
  SITEMAP_NESTED_INDEX_NOT_SUPPORTED
  SITEMAP_FILE_OUT_OF_SCOPE
  SITEMAP_URL_OUT_OF_SCOPE
}

Links

LinkCrawlerErrorCode — on individual findSiteLink items. See Site: Links.

enum LinkCrawlerErrorCode {
  LINK_CRAWLER_UNEXPECTED_ERROR
  LINK_CRAWLER_LIMIT_REACHED
}

Uptime

UptimeErrorCode — on findUptimeLinkRecord items and lastRecord. See Uptime.

enum UptimeErrorCode {
  UPTIME_STATUS_CODE
  UPTIME_TIMEOUT
  UPTIME_KEYWORD_MATCH
  UPTIME_TOO_MANY_REDIRECTS
  UPTIME_SSL
  UPTIME_CONNECTION
  UPTIME_REQUEST
  UPTIME_UNEXPECTED
}

On this page