POST /seedlisting/{id}/terminate

POST 
seedlisting/:id/terminate

Terminate an active seedlisting inbox placement test before it completes

Path Parameters

id string Required
Unique identifier of the seedlisting test

Returns

• dataobject
  • idstring
    Unique identifier of the seedlisting test
  • titlestring
    Name of the seedlisting test
  • profile_idstring
    Profile ID associated with this seedlisting test
  • statusstring
    Current status of the seedlisting test
    Allowed values: INIT, ACTIVE, DONE, FAILED, TERMINATED
  • check_typestring
    Type of seedlisting check to perform, which determines the method of matching incoming emails
    Allowed values: TAG, H_TO, REF, EXPRESS
  • created_atstring
    Timestamp when the seedlisting test was created
  • updated_atstring
    Timestamp when the seedlisting test was last updated
  • tagstring
    Tag identifier used to match incoming emails; present only when check_type is TAG
  • email_ref_addrstring
    Reference email address used for routing; present only when check_type is REF
  • statsobject
    Aggregated delivery statistics for this seedlisting test
    • inboxnumber
      Number of emails delivered to the inbox
    • spamnumber
      Number of emails delivered to the spam or junk folder
    • waitingnumber
      Number of emails pending delivery results
    • not_receivednumber
      Number of emails not received
  • ipsarray
    List of detected sending IP addresses with DNS and RBL lookup results
    • ipstring
      Sending IP address detected during the seedlisting test
    • dns_lookup_resultarray
      DNS lookup results for the sending IP address
      • addressesarray
        List of resolved IP addresses for the sending hostname
      • rDNSstring
        Reverse DNS lookup result for the IP address
    • rbl_resultarray
      Real-time blocklist lookup results for the sending IP address
      • lookup_hoststring
        The RBL hostname used for the blocklist lookup
  • fromobject
    Sender information including DNS and RBL lookup results
    • titlestring
      Display name of the sender
    • domainstring
      Sender's domain name
    • dns_lookup_resultarray
      DNS lookup results for the sender's domain
      • ipstring
        IP address resolved from the domain's DNS records
    • rbl_resultarray
      Real-time blocklist lookup results for the sender's domain
      • lookup_hoststring
        The RBL hostname used for the domain blocklist lookup
  • spfobject
    SPF record evaluation results for the sender's domain
    • domainstring
      Domain against which the SPF record was evaluated
    • resultboolean
      Indicates whether the SPF check passed
    • dnsQueriesToResolvenumber
      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 signature validation results
    • domainstring
      Domain against which the DKIM signature was validated
    • selectorstring
      DKIM selector used for public key lookup
    • resultstring
      DKIM validation result
    • warningsarray
      Non-critical issues found during DKIM validation
    • errorsarray
      Critical errors found during DKIM validation
  • dmarcobject
    DMARC policy evaluation results for the sender's domain
    • domainstring
      Domain against which the DMARC policy was evaluated
    • resultarray
      DMARC evaluation result
    • warningsarray
      Non-critical issues found during DMARC evaluation

Error Codes

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

404 Not Found

Not Found

500 Internal Server Error

Internal server error