Clearout
App · Email · 13 actions
Check whether an email address is real and safe to send to, find someone's work address from their name and company, and look up the person or company behind an address, a LinkedIn profile or a domain.
Actions
| Action | What it does |
|---|---|
| Check a name | Check whether a name is a real person's name. |
| Check verification progress | See how far Clearout has got through a list. |
| Delete a list | Remove a list from Clearout for good. |
| Find an email address | Find someone's work email address from their name and their company. |
| Get remaining credits | See how many Clearout credits are left, broken down by where they came from. |
| Get verification results | Get a link to the finished results of a list, as a spreadsheet holding every address and its verdict. |
| List your email lists | List the email lists on the Clearout account, newest first, with the id each one is addressed by. |
| Look up a company by domain | Find out which company is behind a website: its name, LinkedIn page and where it is based. |
| Look up a person by email | Find out who is behind an email address: their name, job title, company, LinkedIn profile and where they are based. |
| Look up a person by LinkedIn profile | Find out who is behind a LinkedIn profile: their name, job title, company and where they are based. |
| Stop verifying a list | Stop a list that is part-way through being verified. |
| Verify a list of email addresses | Start verifying a whole list of addresses at once. |
| Verify an email address | Check whether an email address is real and safe to send to. |
Check a name
Check whether a name is a real person's name. Clearout's model catches the keyboard mash, the joke and the profanity that a sign-up form collects, which no pattern match can. Costs two Clearout credits.
Inputs
- Name
nametextRequired - The name to check, for example Jane Doe.
- Gibberish detection
gibberish_detectiontext - How hard to look for a keyboard mash. Lower this if real names are being turned away.One of:
off,medium,high. Default:high.
Outputs
gibberishtrue/false- True when the name is a keyboard mash rather than a name.
nametext- The name that was checked.
profanitytrue/false- True when the name contains profanity.
resulttext- Clearout's verdict on the name, such as 'valid' or 'invalid'.
statustext- Status of the action execution ("success" on success).
time_takennumber- How long the check took, in milliseconds.
Example output
{
"gibberish": false,
"name": "Jane Doe",
"profanity": false,
"result": "valid",
"status": "success",
"time_taken": 61
}Check verification progress
See how far Clearout has got through a list. 100% means every address has been verified; Clearout then takes a few seconds more to build the results file, which 'Get verification results' waits for on its own. This is free and costs no credits.
Inputs
- List
list_idtextRequired - The list to act on. Pick one, or use the id that 'Verify a list of email addresses' returned -- a list created moments ago is newer than the names offered here.
Outputs
list_idtext- The list that was checked.
percent_completenumber- How far through the list Clearout is, from 0 to 100.
progress_statustext- What Clearout is doing with the list, e.g. 'completed'.
statustext- Status of the action execution ("success" on success).
Example output
{
"list_id": "5c60eb454506101c9d2f7b17",
"percent_complete": 100,
"progress_status": "completed",
"status": "success"
}Delete a list
Remove a list from Clearout for good. Its results go with it unless you keep them. This cannot be undone. Deleting costs no credits, and does not refund the ones the list spent.
Inputs
- List
list_idtextRequired - The list to act on. Pick one, or use the id that 'Verify a list of email addresses' returned -- a list created moments ago is newer than the names offered here.
- Keep the results
keep_resultstrue/false - Leave the verification results behind after the list itself is gone, so they can still be downloaded.Default:
false.
Outputs
deletedtrue/false- True once Clearout removed the list.
kept_resultstrue/false- True when the results were left behind.
list_idtext- The list that was deleted.
statustext- Status of the action execution ("success" on success).
Example output
{
"deleted": true,
"kept_results": false,
"list_id": "5c60eb454506101c9d2f7b17",
"status": "success"
}Find an email address
Find someone's work email address from their name and their company. Clearout verifies each address before returning it, so anything it finds is already checked. Costs four Clearout credits, or two for a role address, and nothing when no address is found.
Inputs
- Person's name
nametextRequired - Their full name, for example Jane Doe.
- Company
companytextRequired - Their company's name or website, for example Example Corp or example.com.
- Wait up to (seconds)
wait_secondsnumber - How long to keep looking before giving up. A search that needs longer carries on at Clearout and its result appears there under Activities.From 5 to 180. Default:
60.
Outputs
company_nametext- The company's name.
confidence_scorenumber- How confident Clearout is, from 0 to 100.
domaintext- The company domain that was searched.
email_addresstext- The best address Clearout found, or empty when it found none. This is the field to use.
emailslist- Every address Clearout found, best first.
first_nametext- The person's first name.
foundtrue/false- True when an address was found.
found_ontext- When the search ran (ISO-8601).
full_nametext- The person's full name.
last_nametext- The person's last name.
messagetext- What to do next, when Clearout is still searching. Empty otherwise.
statustext- Status of the action execution ("success" on success).
still_searchingtrue/false- True when Clearout ran out of the time it was given and is still looking in the background.
totalnumber- How many addresses were found.
Example output
{
"company_name": "Example Corp",
"confidence_score": 96,
"domain": "example.com",
"email_address": "jane.doe@example.com",
"emails": [
{
"business": true,
"email_address": "jane.doe@example.com",
"role": false
}
],
"first_name": "Jane",
"found": true,
"found_on": "2026-09-18T12:44:02.000Z",
"full_name": "Jane Doe",
"last_name": "Doe",
"message": "",
"status": "success",
"still_searching": false,
"total": 1
}Get remaining credits
See how many Clearout credits are left, broken down by where they came from. Use it to stop a large job before it runs out part-way. This is free and costs no credits.
Inputs
None.
Outputs
bonus_creditsnumber- Free and promotional credits.
low_credit_balance_min_thresholdnumber- The balance at which Clearout sends its low-credit alert.
pay_as_you_go_creditsnumber- Credits bought as pay-as-you-go.
statustext- Status of the action execution ("success" on success).
subscription_creditsnumber- Credits from the account's subscription.
total_remaining_creditsnumber- Every credit still available, added together.
Example output
{
"bonus_credits": 100,
"low_credit_balance_min_threshold": 50,
"pay_as_you_go_credits": 14463,
"status": "success",
"subscription_credits": 100000,
"total_remaining_credits": 114563
}Get verification results
Get a link to the finished results of a list, as a spreadsheet holding every address and its verdict. Clearout builds that file after the last address is verified, so this waits for it rather than refusing. The link is temporary, so use it in the same run. This is free and costs no credits.
Inputs
- List
list_idtextRequired - The list to act on. Pick one, or use the id that 'Verify a list of email addresses' returned -- a list created moments ago is newer than the names offered here.
Outputs
list_idtext- The list the results belong to.
results_urltext- A temporary link to the results spreadsheet. It expires shortly after this step runs.
statustext- Status of the action execution ("success" on success).
Example output
{
"list_id": "5c60eb454506101c9d2f7b17",
"results_url": "https://clearout.s3.amazonaws.com/results/newsletter_signups_clearout_results.csv",
"status": "success"
}List your email lists
List the email lists on the Clearout account, newest first, with the id each one is addressed by. Narrow it to when a list was created or what state it is in. This is free and costs no credits.
Inputs
- Created
createdtext - Only lists created in this window. Leave blank for the last 7 days, which is what Clearout shows by default.One of:
ps_today(Today),ps_yesterday(Yesterday),ps_last_24_hours(The last 24 hours),ps_this_week_mon_today(This week (from Monday)),ps_last_7_days_including_today(The last 7 days),ps_last_week_mon_sun(Last week (Monday to Sunday)),ps_this_month(This month),ps_last_30_days(The last 30 days). - State
statetext - Only lists in this state. Leave blank for every state.One of:
non_verified(Not verified yet),in_progress(Being verified now),verified,cancelled(Stopped part-way). - Maximum results
limitnumber - How many lists to return, up to 100.From 1 to 100. Default:
10. - Next page
page_tokentext - To read the next page, use the 'page_token' this action returned. Leave blank for the first page.
Outputs
countnumber- How many lists were returned.
has_moretrue/false- True when there is another page.
listslist- The lists on the account, newest first.
page_tokentext- Send this back as 'Next page' to read the next page. Empty when there are no more.
statustext- Status of the action execution ("success" on success).
Example output
{
"count": 1,
"has_more": false,
"lists": [
{
"action_inprogress": {
"action": null,
"status": null
},
"created_on": "2026-09-18T09:12:04.000Z",
"last_analysed_on": "2026-09-18T09:31:58.000Z",
"last_cancelled_on": null,
"last_exported_on": null,
"last_verified_on": "2026-09-18T09:31:55.000Z",
"list_id": "5c60eb454506101c9d2f7b17",
"name": "Newsletter sign-ups",
"non_verified_list_expires_on": null,
"result_expires_on": 1790000000,
"type": "upload"
}
],
"page_token": "",
"status": "success"
}Look up a company by domain
Find out which company is behind a website: its name, LinkedIn page and where it is based. A full web address works as well as a bare domain. Costs Clearout credits only when a company is found.
Inputs
- Domain
domaintextRequired - The company's website, for example example.com.
Outputs
companyobject- Everything Clearout knows about the company. Empty if none was found.
domaintext- The domain that was looked up.
foundtrue/false- True when a company was found.
statustext- Status of the action execution ("success" on success).
Example output
{
"company": {
"addresses": [
{
"country": "United States",
"country_code": "US",
"full_address": "San Francisco, United States"
}
],
"id": "5c60eb454506101c9d2f7b18",
"linkedin_url": "https://www.linkedin.com/company/example-corp",
"name": "Example Corp",
"profile_picture": "https://media.example.com/logo.png",
"type": "company"
},
"domain": "example.com",
"found": true,
"status": "success"
}Look up a person by email
Find out who is behind an email address: their name, job title, company, LinkedIn profile and where they are based. Costs four Clearout credits, or two for a role address, and nothing when nobody is found.
Inputs
- Email address
emailtextRequired - The address to look up, for example jane@example.com.
Outputs
email_addresstext- The address that was looked up.
foundtrue/false- True when somebody was found.
personobject- Everything Clearout knows about the person. Empty if none was found.
statustext- Status of the action execution ("success" on success).
Example output
{
"email_address": "jane@example.com",
"found": true,
"person": {
"addresses": [
{
"city": "San Francisco",
"country": "United States",
"country_code": "US",
"full_address": "San Francisco, California, United States",
"state": "California"
}
],
"company_domain": "example.com",
"company_name": "Example Corp",
"contructed_title": "Head of Marketing at Example Corp",
"id": "5c60eb454506101c9d2f7b17",
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"name": "Jane Doe",
"profile_picture": "https://media.example.com/jane.jpg",
"title": "Head of Marketing",
"total_experience_in_months": 142,
"type": "person"
},
"status": "success"
}Look up a person by LinkedIn profile
Find out who is behind a LinkedIn profile: their name, job title, company and where they are based. Costs four Clearout credits, and nothing when nobody is found.
Inputs
- LinkedIn profile
linkedin_urltextRequired - The address of the profile, for example https://www.linkedin.com/in/janedoe.
Outputs
foundtrue/false- True when somebody was found.
linkedin_urltext- The profile that was looked up.
personobject- Everything Clearout knows about the person. Empty if none was found.
statustext- Status of the action execution ("success" on success).
Example output
{
"found": true,
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"person": {
"addresses": [
{
"city": "San Francisco",
"country": "United States",
"country_code": "US",
"full_address": "San Francisco, California, United States",
"state": "California"
}
],
"company_domain": "example.com",
"company_name": "Example Corp",
"contructed_title": "Head of Marketing at Example Corp",
"id": "5c60eb454506101c9d2f7b17",
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"name": "Jane Doe",
"profile_picture": "https://media.example.com/jane.jpg",
"title": "Head of Marketing",
"total_experience_in_months": 142,
"type": "person"
},
"status": "success"
}Stop verifying a list
Stop a list that is part-way through being verified. Clearout keeps the results for the addresses it already checked and spends credits on those only; the rest are left unverified. Stopping can take up to fifteen minutes to take effect. A list that is not being verified (finished, stopped already, or never started) is reported rather than treated as a failure.
Inputs
- List
list_idtextRequired - The list to act on. Pick one, or use the id that 'Verify a list of email addresses' returned -- a list created moments ago is newer than the names offered here.
Outputs
cancelledtrue/false- True when Clearout stopped a verification that was running. False when there was nothing to stop.
list_idtext- The list this was aimed at.
reasontext- Why nothing was stopped, when nothing was. Empty when the verification was stopped.
statustext- Status of the action execution ("success" on success).
Example output
{
"cancelled": true,
"list_id": "5c60eb454506101c9d2f7b17",
"reason": "",
"status": "success"
}Verify a list of email addresses
Start verifying a whole list of addresses at once. Clearout works through it in the background and answers straight away with the list's id: use 'Check verification progress' to follow it and 'Get verification results' to download the outcome. Duplicates are dropped before the list is sent. Costs one Clearout credit per address, charged as each one is verified.
Inputs
- Email addresses
emailslistRequired - The addresses to verify. Usually a list from an earlier step, such as a column of a spreadsheet.
- List name
nametext - What to call this list in Clearout. Leave it blank and it is named after today's date.
- Optimise for
optimize_fortext - Whether Clearout should take the time to be as accurate as it can, or get through the list as fast as it can.One of:
highest_accuracy(Highest accuracy),fastest_turnaround(Fastest turnaround). Default:highest_accuracy.
Outputs
email_countnumber- How many addresses were sent, after duplicates.
list_idtext- The new list's id. The other list actions take this.
nametext- The name the list was given in Clearout.
optimize_fortext- What the verification was optimised for.
statustext- Status of the action execution ("success" on success).
Example output
{
"email_count": 1240,
"list_id": "5c60eb454506101c9d2f7b17",
"name": "Newsletter sign-ups",
"optimize_for": "highest_accuracy",
"status": "success"
}Verify an email address
Check whether an email address is real and safe to send to. Returns Clearout's verdict (valid, invalid, catch_all or unknown) along with whether the address is disposable, free, a role address such as sales@, or gibberish, and a suggested correction when the address looks like a typo. Costs one Clearout credit, except when the verdict is unknown.
Inputs
- Email address
emailtextRequired - The address to check, for example jane@example.com.
- Wait up to (seconds)
wait_secondsnumber - How long to give Clearout before it gives up and answers 'unknown'. Leave it as it is unless somebody is waiting on the result, in which case shorten it.From 5 to 180. Default:
60.
Outputs
accounttext- The part of the address before the @.
blacklist_infolist- Any blocklists the address or its domain is on.
bounce_typetext- How a message would bounce -- 'hard' or 'soft' -- when it would.
disposabletrue/false- True for a throwaway address from a temporary-mail service.
domaintext- The part of the address after the @.
email_addresstext- The address that was checked.
email_providertext- Who runs that mail server, e.g. 'google' or 'microsoft'.
freetrue/false- True for a free provider such as Gmail or Outlook.com, rather than a company's own domain.
gibberishtrue/false- True when the address looks machine-generated rather than chosen by somebody.
mx_recordtext- The mail server the domain receives mail on.
profiletext- Public profile information Clearout holds, if any.
reasontext- Why Clearout reached that verdict.
reason_codenumber- Clearout's code for that reason.
resulttext- Clearout's verdict: 'valid', 'invalid', 'catch_all' (the domain accepts everything, so the mailbox cannot be confirmed) or 'unknown'.
roletrue/false- True for an address that belongs to a role rather than a person, such as sales@ or support@.
safe_to_sendtext- Whether to send to it: 'yes', 'no' or 'risky'. This is the field to branch on.
scorenumber- Clearout's confidence in the verdict.
statustext- Status of the action execution ("success" on success).
suggested_email_addresstext- A likely fix for a typo (jane@gmal.com to jane@gmail.com), or empty when Clearout has no suggestion.
time_takennumber- How long the check took, in milliseconds.
verified_ontext- When it was checked (ISO-8601).
Example output
{
"account": "jane",
"blacklist_info": [],
"bounce_type": "",
"disposable": false,
"domain": "example.com",
"email_address": "jane@example.com",
"email_provider": "google",
"free": false,
"gibberish": false,
"mx_record": "aspmx.l.google.com",
"profile": null,
"reason": "Success",
"reason_code": 200,
"result": "valid",
"role": false,
"safe_to_send": "yes",
"score": 1,
"status": "success",
"suggested_email_address": "",
"time_taken": 432,
"verified_on": "2026-09-18T12:42:53.000Z"
}