GET /seedlisting/{id}

GET 
seedlisting/:id

Retrieve a specific seedlisting inbox placement test by its ID

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
  • emailsarray
    List of seed email records for this seedlisting test
    • idstring
      Unique identifier of the seedlisting email record
    • statusstring
      Delivery status of the seed email
    • processing_statusstring
      Processing status of the seed email
    • seedlisting_idstring
      Reference to the parent seedlisting test
    • profile_idstring
      Profile ID associated with this seedlisting email record
    • emailstring
      Seed email address
    • hoststring
      Email provider host for this seed address
    • fromstring
      Sender email address
    • ipstring
      Sending IP address detected for this email
    • received_timestampstring
      Timestamp when the email was received by the seed account
    • sended_timestampstring
      Timestamp when the test email was sent
    • subjectstring
      Subject line of the test email
    • spamassasinobject
      SpamAssassin analysis results for this email
      • allowednumber
        Maximum allowed spam score threshold
      • evaluationnumber
        Calculated spam score assigned to the email
      • spamboolean
        Indicates whether the email was classified as spam
      • rulesobject
        SpamAssassin rules that matched the email
        • namestring
          Name of the matched SpamAssassin rule
        • descriptionstring
          Description of the matched SpamAssassin rule
        • scorenumber
          Score assigned by the matched SpamAssassin rule

Error Codes

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

404 Not Found

Not Found

500 Internal Server Error

Internal server error