POST /domains/{id}/refresh

POST 
domains/:id/refresh

Refresh domain information by ID. Sets domain's status to WAITING and sends domain for validation. Can not be used more than once in 5 minutes for one domain.

Path Parameters

id string Required
Domain ID

Returns

• dataobject
  • idstring
    Unique identifier of the domain
  • domainstring
    Domain name being monitored
  • dns_lookup_resultarray
    DNS lookup results containing resolved IP addresses
    • ipstring
      Resolved IP address for the domain
  • rbl_resultarray
    Blacklist check results from various RBL providers
    • lookup_hoststring
      RBL provider hostname that was queried
  • spfobject
    SPF record validation results and details
    • domainstring
      Domain against which the SPF record was evaluated
    • resultboolean
      Indicates whether the SPF check passed
    • dns_queries_to_resolvenumber
      Number of DNS queries required to fully resolve the SPF record
    • recordstring
      The raw SPF TXT record retrieved from DNS
    • warningsarray
      Non-critical issues found during SPF evaluation
    • mechanismsarray
      List of SPF mechanisms parsed from the record
      • mechanismstring
        The SPF mechanism
      • modifierstring
        The SPF modifier
      • dataobject
        The data associated with the mechanism
      • warningstring
        Warning message if an issue was detected with this mechanism
      • is_dns_query_to_resolveboolean
        Indicates whether this mechanism requires a DNS lookup
      • domainstring
        The domain associated with this mechanism
  • dkimarray
    DKIM configuration and validation results for all selectors
    • resultstring
      DKIM validation result
    • selectorstring
      DKIM selector used for public key lookup
    • errorsarray
      Critical errors found during DKIM validation
    • warningsarray
      Non-critical issues found during DKIM validation
  • dmarcobject
    DMARC policy validation results and configuration
    • resultarray
      DMARC evaluation result
    • warningsarray
      Non-critical issues found during DMARC evaluation
  • statusstring
    Current processing status of the domain
  • updated_atstring
    Timestamp when the domain information was last updated

Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

404 Not Found

Not Found

500 Internal Server Error

Internal server error