---
title: "Get Email validation lists information"
method: GET
path: "/emailvalidation/lists"
tags: ["email-validator"]
---

# Get Email validation lists information

`GET /emailvalidation/lists`

List files for email validation information

## Query parameters

- `page` integer, nullable — Page number. Must be an integer greater than 0.
- `limit` integer, nullable — The number of rows per page to return. Must be an integer greater than 0.
- `from` string, date, required — Start date
- `to` string, date, required — End date
- `tz` string — Timezone Offset

## Response `200`

Sucess

Get Email Validation Lists Data.

- EmailValidatorSucessResponsetBody
  - `count` integer
  - `results` EmailValidatorList[]
    - `id` integer — Email validation list id.
    - `creation_time` string
    - `file_name` string — File name of the uploaded file.
    - `is_processed` boolean — True if the validation list was already processed.
    - `percentage` integer — Describes the percentage progress of validation list.
    - `total_emails` integer — Amount of email addresses in the validation list.
    - `total_processed` integer — Describes the count of email addresses processed so far.
    - `status_summary` EmailValidatorStatusSummaryItem[]
      - `status` 'valid' | 'invalid' | 'catch_all' | 'unknown' | 'spamtrap' | 'abuse' | 'do_not_mail' — The status of the email address you are validating. DELIVERABILITY STATUS EXPLANATION valid: These are emails that were determined to be valid and safe to email to, they will have a very low bounce rate of under 2%. If you receive bounces it can be because your IP might be blacklisted where our IP was not. Sometimes the email accounts exist, but they are only accepting mail from people in their contact lists. Sometimes you will get throttle on number of emails you can send to a specific domain per hour. It's important to look at the SMTP Bounce codes to determine why. invalid: These are emails that were determined to be invalid, please delete them from your mailing list. catch-all: These emails are impossible to validate without sending a real email and waiting for a bounce. The term Catch-all means that the email server tells you that the email is valid, whether it's valid or invalid. If you want to email these addresses, we suggest you segment them into a catch-all group and be aware that some of these will most likely bounce. spamtrap: These emails are believed to be spamtraps and should not be mailed. We have technology in place to determine if certain emails should be classified as spamtrap. We don't know all the spamtrap email addresses, but we do know a lot of them. abuse: These emails belong to people who are known to click the abuse links in emails, hence abusers or complainers. We recommend not emailing these addresses. do_not_mail: These emails belong to companies, role-based, or people you just want to avoid emailing to. They are broken down into 6 sub-categories "disposable","toxic", "role_based", "role_based_catch_all", "global_suppression" and "possible_trap". You should decide if you want to email these address. They are valid email addresses, but shouldn't be mailed in most cases. unknown: These emails we weren't able to validate for one reason or another. Typical cases are "Their mail server was down" or "the anti-spam system is blocking us". In most cases, 80% unknowns are invalid/bad email addresses.
      - `total` integer — Ammount of emails in the status within the list.

## Other responses

- `401` — Unauthorized This API requires a valid API Key to be provided. (Use [/authentication/authorize](#/authentication/AuthenticationLogin) to obtain an API Key) Produces: * missing_authorization_key * invalid_authorization_key * account_is_inactive

---

[API](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis.md) · [All operations](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serversmtp/turbosmtp-public-apis/versions/8503e099b215/schema)