Skip to main content

GET /listcleaning/list/{id}/results

GET 
listcleaning/list/:id/results

Retrieve the detailed email-level results for a specific list cleaning job

Path Parameters​

id string Required

Query Parameters​

offset string
Number of items to skip before starting to return results

limit string
Maximum number of items to return per request

status string
Filter by verification status. Multiple values can be provided separated by comma. Example: deliverable,risky

reason string
Filter by verification reason. Multiple values can be provided separated by comma. Example: dns_error,unsupported

accept_all string
Filter by accept_all status

disposable string
Filter by disposable status

full_mailbox string
Filter by full_mailbox status

toxicity string
Filter by toxicity level (0 = lowest, 5 = highest)

Returns

  • dataarray
    • emailstring
      Email address that was verified
    • statusstring
      Verification status of the email (deliverable, risky, undeliverable, or unknown)
    • reasonstring
      Reason for the assigned status
    • domainobject
      Information about the email's domain
      • namestring
        Domain name of the email address
      • accept_allstring
        Indicates if the domain accepts all emails (yes, no, or unknown)
      • disposablestring
        Indicates if the domain is a disposable email service (yes, no, or unknown)
      • freestring
        Indicates if the domain is a free email provider (yes, no, or unknown)
    • accountobject
      Information about the email account
      • rolestring
        Indicates if the email is a role-based address (yes, no, or unknown)
      • disabledstring
        Indicates if the email account is disabled (yes, no, or unknown)
      • full_mailboxstring
        Indicates if the mailbox is full (yes, no, or unknown)
    • dnsobject
      DNS information for the email's domain
      • typestring
        Type of DNS record (e.g., MX, A)
      • recordstring
        DNS record value
    • providerstring
      Email service provider name
    • scorenumber
      Overall quality score of the email address
    • toxicstring
      Indicates if the email is toxic (yes, no, or unknown)
    • toxicitynumber
      Toxicity level from 0 (lowest) to 5 (highest)
  • metaobject
    Pagination metadata for list responses
    • countinteger
      Total number of items available
    • offsetinteger
      Number of items skipped
    • limitinteger
      Maximum number of items returned per request
Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error