safe_to_send: Email address is deliverable and has low-to-no threats detected.
\nsend_with_caution: The email address is possibly deliverable or has an elevated threat level.
\ndo_not_send: Email address is undeliverable or high threat level detected.
\nexcellent: Email address is deliverable, with no known threats detected.
\ngood: Email address is deliverable, with a low threat level detected.
\nfair: Email address is deliverable, with a low-to-moderate threat level detected.
\npoor: Email address is possibly deliverable or moderate-to-high threat level detected.
\nbad: Email address is undeliverable or high threat level detected.
\nAll emails are scored for quality on a 1 through 10 basis, with 10 having the best overall quality and 1 having the worst.
\ndeliverable: A deliverable result means the recipient's mail server stated the recipient exists.
\npossibly_deliverable: Possibly deliverable means that the address has quality issues that may result in a bounce or low engagement. Classifications include Catch-all, Disposable, and Role-based addresses; therefore, use caution when sending to addresses that are possibly deliverable.
\nundeliverable: An undeliverable result means the email address does not exist or is syntactically incorrect (and therefore does not exist).
\nunknown_deliverability: Alfred will return an unknown result when it could not get a response from the recipient's mail server. This happens when the destination mail server is too slow or temporarily unavailable. In some cases, retrying your request after about 5 minutes will return a valid or invalid response. Unknown addresses don't count against your credits.
\naccepted_email: Email address was accepted by the SMTP server.
\ncatch_all: Some domains accept all emails you send to them, even if the email address is not valid. We classify these addresses as \"catch_all\". After an email is sent, the recipient mail server may silently discard the message or send a bounce message after the fact. In these cases, Alfred cannot guarantee an email will be delivered to a user's inbox. Sending to an Accept All domain may increase your bounce rates and lower your open rates. Therefore, use a degree of caution when sending to catch-alls.
\ndisposable: Email addresses that point to domains like spamgourmet.com and mailinator.com are disposable email services. These services enable users to create one-time email addresses to receive initial communications from a service (such as an activation email or coupon) which are then discarded. It is highly recommended you do not mail to disposable email addresses.
\ninvalid_email: Specified email is not a valid email address syntax.
\ninvalid_domain: Domain name does not exist or is not configured to receive email.
\nrejected_email: The email address was rejected by the SMTP server; the email address does not exist.
\ndns_error: We could not resolve the DNS records, or the domain is misconfigured.
\nunavailable_smtp: The SMTP server was unavailable to process our request.
\nunknown: An unexpected error has occurred.
\nrole_based: A role email is an address that's typically associated with a function (postmaster, support, sales, etc.) instead of a person. In some instances, mailing to a role address can lead to a decreased open rate and is generally advised against while sending marketing emails.
\nmailbox_disabled: Email address exists but is disabled and won't be able to receive email.
\nmailbox_full: The inbox of this recipient is full, it might generate a soft bounce.
\nsuspicious: Email address appears to be system or non-human-generated bots.
\ndangerous: Domain and address associated with consistent negative engagement.
\nmalicious: Domain and address associated with elevated negative engagement.
\nundetermined: No known threats were detected, and the risk to mailing reputation is unknown.
\nlow: Email address is widely circulated; risk to mailing reputation is low.
\nmoderate: Email address is widely circulated, non-human generated, identified in a data breach, or associated with negative engagement; risk to mailing reputation is moderate.
\nhigh: Email address is associated with dangerous or malicious contact or domain; risk to mailing reputation is high.
\nBase URL: https://api.hygiene.email/api/v1/
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Glossary","slug":"glossary"},{"content":"API","slug":"api"}],"owner":"9032336","collectionId":"93a0be7c-ee2f-451d-aae8-514d9f159d03","publishedId":"2s935rKNBX","public":true,"customColor":{"top-bar":"F1F1F1","right-sidebar":"303330","highlight":"6AB167"},"publishDate":"2023-02-08T19:04:49.000Z"},"item":[{"name":"credits","item":[{"name":"credits-check","id":"69504e65-23dd-41e9-834a-d699fae62743","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"text"}],"url":"https://my.alfredknows.com/api/v1/credits-check","urlObject":{"protocol":"https","path":["api","v1","credits-check"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"ad54da3e-fd1c-45b4-990d-b779ebaacc6a","name":"credits-check","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"text"}],"url":"https://my.alfredknows.com/api/v1/credits-check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"credits\": 241411\n}"}],"_postman_id":"69504e65-23dd-41e9-834a-d699fae62743"}],"id":"e2fb5974-f0cc-4afc-b153-41ad11bee820","description":"This endpoint can be used to check how many email verification credits are available in your account.
\n","_postman_id":"e2fb5974-f0cc-4afc-b153-41ad11bee820"},{"name":"batch","item":[{"name":"Upload API","item":[{"name":"upload","id":"1d401179-6ede-45cf-a1a2-18cd814776c9","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","value":null}]},"url":"https://my.alfredknows.com/api/v1/upload","description":"API to upload a CSV (.csv) or excel (.xls/.xlsx) file.
\n","urlObject":{"protocol":"https","path":["api","v1","upload"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"3dd6e69c-494c-4e31-aae8-f2e917114418","name":"Created","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":" < Api-Key >","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"","value":"","type":"default","disabled":true},{"key":"file","type":"file","value":null}]},"url":"https://my.alfredknows.com/api/v1/upload"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"callback_url\": null,\n \"file\": \"https://assets.alfredknows.com/staging/uploads/0b5f6d153daf4de899054e8338fb2357-test_file.csv\",\n \"id\": \"0b5f6d153daf4de899054e8338fb2357\",\n \"ignore_global_webhooks\": false,\n \"name\": \"test_file.csv\"\n}"},{"id":"4113afaf-f215-4c5f-8897-a20d9e93f8c5","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":" < Api-Key >","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","value":null}]},"url":"https://my.alfredknows.com/api/v1/upload"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"file\":[\"Invalid file format\"]\n}"}],"_postman_id":"1d401179-6ede-45cf-a1a2-18cd814776c9"},{"name":"upload/{id}","id":"e73f782b-1df9-43b6-969b-2f9cc4bf3392","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"default"}],"url":"https://my.alfredknows.com/api/v1/upload/{id}","description":"API to get details of an uploaded file, by id.
\n","urlObject":{"protocol":"https","path":["api","v1","upload","{id}"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"fffd2629-5aed-4e18-a88b-4fca34c33ff6","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"default"}],"url":"https://my.alfredknows.com/api/v1/upload/0b5f6d153daf4de899054e8338fb2357"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"file\": \"https://assets.alfredknows.com/staging/uploads/0b5f6d153daf4de899054e8338fb2357-test_file.csv\",\n \"callback_url\": null,\n \"ignore_global_webhooks\": false,\n \"id\": \"0b5f6d153daf4de899054e8338fb2357\",\n \"name\": \"test_file.csv\"\n}"},{"id":"a13042f7-d23f-446f-b3b6-97d3e8dc4b15","name":"Not found","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"default"}],"url":"https://my.alfredknows.com/api/v1/upload/1"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"detail\": \"Not found.\"\n}"}],"_postman_id":"e73f782b-1df9-43b6-969b-2f9cc4bf3392"},{"name":"upload","id":"d2af7373-9f42-44ea-8b30-d230e680a450","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"GET","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"default"}],"url":"https://my.alfredknows.com/api/v1/upload","description":"API to get the list of uploaded files.
\n","urlObject":{"protocol":"https","path":["api","v1","upload"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"85145e9a-c0ee-4ee0-973f-4bde3cd5fd67","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"API to create an \"evaluation\" or \"verification\" job for an uploaded file (pass uploaded file id).
\n","urlObject":{"protocol":"https","path":["api","v1","jobs"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"8e59002c-3431-40e4-8d56-bbd70e79d0a4","name":"evaluation job","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"body":{"mode":"raw","raw":"{\"input_file\":{\"id\":\"986fe5e64e1347f1b9fc3915a5178a2c\"},\"actions\":[\"evaluation\"]}","options":{"raw":{"language":"json"}}},"url":"https://my.alfredknows.com/api/v1/jobs"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"input_file\": {\n \"id\": \"0b5f6d153daf4de899054e8338fb2357\",\n \"file\": \"https://assets.alfredknows.com/staging/uploads/0b5f6d153daf4de899054e8338fb2357-test_file.csv\",\n \"name\": \"test_file.csv\",\n \"created_at\": \"2022-03-02T11:46:09.555864Z\"\n },\n \"actions\": [\n \"evaluation\"\n ],\n \"callback_url\": null,\n \"ignore_global_webhooks\": false,\n \"id\": 8891,\n \"result\": null,\n \"result_file\": null,\n \"credit_cost\": 0,\n \"emails_count\": 1000,\n \"status\": \"CREATED\",\n \"created_by\": \"scott@emailindustries.com\",\n \"created_with\": \"API\",\n \"created_at\": \"2022-03-02T11:48:24.401795Z\"\n}"},{"id":"b8c7ad7a-1343-4d9b-a86e-b5e70a137f56","name":"verification job","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"API to get the list of jobs.
\n","urlObject":{"protocol":"https","path":["api","v1","jobs"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"b3436441-8277-4896-ae1c-0061949bbdfd","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"url":"https://my.alfredknows.com/api/v1/jobs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 2,\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"input_file\": {\n \"id\": \"0b5f6d153daf4de899054e8338fb2357\",\n \"file\": \"https://assets.alfredknows.com/staging/uploads/0b5f6d153daf4de899054e8338fb2357-test_file.csv\",\n \"name\": \"test_file.csv\",\n \"created_at\": \"2022-02-11T09:09:29.131301Z\"\n },\n \"actions\": [\n \"verification\"\n ],\n \"callback_url\": null,\n \"ignore_global_webhooks\": false,\n \"id\": 16147,\n \"result\": {\n \"verification_job\": {\n \"scores\": [\n {\n \"score\": 1,\n \"email_count\": 100\n },\n {\n \"score\": 2,\n \"email_count\": 100\n },\n {\n \"score\": 3,\n \"email_count\": 100\n },\n {\n \"score\": 4,\n \"email_count\": 100\n },\n {\n \"score\": 5,\n \"email_count\": 100\n },\n {\n \"score\": 6,\n \"email_count\": 100\n },\n {\n \"score\": 7,\n \"email_count\": 100\n },\n {\n \"score\": 8,\n \"email_count\": 100\n },\n {\n \"score\": 9,\n \"email_count\": 100\n },\n {\n \"score\": 10,\n \"email_count\": 100\n }\n ],\n \"deliverability\": {\n \"deliverable\": 300,\n \"undeliverable\": 200,\n \"possibly_deliverable\": 400,\n \"unknown_deliverability\": 100\n },\n \"threat\": {\n \"matched_count\": 1000,\n \"threat_scores\": [\n {\n \"score\": 1,\n \"email_count\": 100\n },\n {\n \"score\": 2,\n \"email_count\": 200\n },\n {\n \"score\": 3,\n \"email_count\": 200\n },\n {\n \"score\": 4,\n \"email_count\": 200\n },\n {\n \"score\": 5,\n \"email_count\": 100\n }\n ]\n },\n \"reasons\": {\n \"unknown\": 100,\n \"catch_all\": 100,\n \"dangerous\": 100,\n \"dns_error\": 100,\n \"malicious\": 100,\n \"role_based\": 100,\n \"suspicious\": 100,\n \"mailbox_full\": 100,\n \"accepted_email\": 100,\n \"rejected_email\": 100\n }\n }\n },\n \"result_file\": \"https://my.alfredknows.com/api/v1/jobs/16147/download\",\n \"credit_cost\": 1000,\n \"emails_count\": 1000,\n \"status\": \"COMPLETED\",\n \"created_by\": \"scott@emailindustries.com\",\n \"created_with\": \"UI\",\n \"created_at\": \"2022-02-11T09:10:15.542913Z\"\n },\n {\n \"input_file\": {\n \"id\": \"b9c3cc6d-91a3-4a6f-babb-758330e97e7b\",\n \"file\": \"https://assets.alfredknows.com/staging/uploads/b9c3cc6d91a34a6fbabb758330e97e7b-test_file_2.xlsx\",\n \"name\": \"test_file_2.xlsx\",\n \"created_at\": \"2022-02-11T09:08:24.670251Z\"\n },\n \"actions\": [\n \"verification\"\n ],\n \"callback_url\": null,\n \"ignore_global_webhooks\": false,\n \"id\": 8889,\n \"result\": {\n \"verification_job\": {\n \"scores\": [\n {\n \"score\": 1,\n \"email_count\": 0\n },\n {\n \"score\": 2,\n \"email_count\": 0\n },\n {\n \"score\": 3,\n \"email_count\": 0\n },\n {\n \"score\": 4,\n \"email_count\": 0\n },\n {\n \"score\": 5,\n \"email_count\": 0\n },\n {\n \"score\": 6,\n \"email_count\": 0\n },\n {\n \"score\": 7,\n \"email_count\": 0\n },\n {\n \"score\": 8,\n \"email_count\": 1\n },\n {\n \"score\": 9,\n \"email_count\": 0\n },\n {\n \"score\": 10,\n \"email_count\": 1\n }\n ],\n \"deliverability\": {\n \"deliverable\": 2,\n \"undeliverable\": 0,\n \"possibly_deliverable\": 0,\n \"unknown_deliverability\": 0\n },\n \"threat\": {\n \"matched_count\": 1,\n \"global_threat_score\": \"3.00\",\n \"threat_scores\": [\n {\n \"score\": 1,\n \"email_count\": 0\n },\n {\n \"score\": 2,\n \"email_count\": 1\n },\n {\n \"score\": 3,\n \"email_count\": 0\n },\n {\n \"score\": 4,\n \"email_count\": 0\n },\n {\n \"score\": 5,\n \"email_count\": 0\n }\n ]\n }\n }\n },\n \"result_file\": \"https://my.alfredknows.com/api/v1/jobs/8889/download\",\n \"credit_cost\": 2,\n \"emails_count\": 2,\n \"status\": \"COMPLETED\",\n \"created_by\": \"scott@emailindustries.com\",\n \"created_with\": \"UI\",\n \"created_at\": \"2022-02-11T09:09:05.323762Z\"\n }\n ]\n}"}],"_postman_id":"a0624692-70dc-4757-b02b-a220f57ae9a2"},{"name":"jobs/{id}","id":"7cc6ad94-ac9c-44a8-a81d-f4b5f93e21cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"url":"https://my.alfredknows.com/api/v1/jobs/{id}","description":"API to get details of a job, by id.
\n","urlObject":{"protocol":"https","path":["api","v1","jobs","{id}"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"9eb6d76f-8271-4276-9c7e-e467ff70aa00","name":"OK (status: CREATED)","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"API to delete a job, by id.
\n","urlObject":{"protocol":"https","path":["api","v1","jobs","{id}"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"288a36d8-924d-4c76-a026-c9341f710573","name":"Deleted","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"API to download the result of a COMPLETED job, by id. The result can be filtered by passing score (1-10) as query params.
\nExample: To get results with score 8 and above, use jobs/download?score=10&score=9&score=8
\n","urlObject":{"protocol":"https","path":["api","v1","jobs","{id}","download"],"host":["my","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"79c64389-e373-4db9-ada3-cde1a1ee4ea9","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"url":"https://my.alfredknows.com/api/v1/jobs/16147/download"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Content-Type","value":"text/csv"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Thu, 16 Jun 2022 09:22:46 GMT"},{"key":"Content-Disposition","value":"attachment; filename=\"test_file__results_06-16-2022.csv\""},{"key":"Allow","value":"GET"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 0e7af4d3c49480f425f8771227667e6a.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MAA51-C2"},{"key":"X-Amz-Cf-Id","value":"im28oCbWw2yEFM7VM8MupaoCSfjvkZzd4AM8jRqVDcDhk3t9eK_Jjw=="}],"cookie":[],"responseTime":null,"body":"Email,recommendation,score,rating,status,reason,threat_level,did_you_mean\r\ndscheuerman1@gmail.com,safe_to_send,9,good,deliverable,accepted_email,undetermined,\r\noffice@krystynastepniak.com,send_with_caution,4,poor,possibly_deliverable,role_based,moderate,\r\nguam@coastalnow.net,do_not_send,2,bad,undeliverable,dangerous,high,\r\nmail@aol.com,do_not_send,2,bad,unknown_deliverability,dangerous,high,\r\nLoquiroz.futureleaders@gmail.com,safe_to_send,9,good,deliverable,accepted_email,undetermined,\r\nkitkatmail4u@yahoo.com,do_not_send,2,bad,deliverable,dangerous,high,\r\nx3786@yahoo.com,do_not_send,2,bad,deliverable,dangerous,high,\r\nbfrancis@cpja.com,do_not_send,2,bad,possibly_deliverable,dangerous,high,\r\ncruzing01@comcast.net,safe_to_send,10,excellent,deliverable,accepted_email,undetermined,\r\ndestrick@sbcglobal.net,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\ndottiboop@att.net,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\ngrayhound2@bellsouth.net,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\nlpassarella@mac.com,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\nlures1@embarqmail.com,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\nmarydipr@bellsouth.net,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\njsteele@knoxvilletn.gov,safe_to_send,10,excellent,deliverable,accepted_email,undetermined,\r\nmillie55@bellsouth.net,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\nbentleysemail@verizon.net,send_with_caution,4,poor,unknown_deliverability,unknown,moderate,\r\nbrbls@aol.com,send_with_caution,4,poor,unknown_deliverability,unknown,moderate,\r\ncconnofkc@aol.com,send_with_caution,5,poor,deliverable,suspicious,moderate,\r\ncharonpop2@aol.com,send_with_caution,4,poor,unknown_deliverability,unknown,moderate,\r\ncheryl.harding@aol.com,send_with_caution,4,poor,unknown_deliverability,unknown,moderate\r\n"},{"id":"34992b8f-d7a4-454a-98b9-97242bb3c7c0","name":"OK (Filtered)","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"url":{"raw":"https://my.alfredknows.com/api/v1/jobs/16147/download?score=10&score=9","protocol":"https","host":["my","alfredknows","com"],"path":["api","v1","jobs","16147","download"],"query":[{"key":"score","value":"10"},{"key":"score","value":"9"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Content-Type","value":"text/csv"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Thu, 16 Jun 2022 09:22:46 GMT"},{"key":"Content-Disposition","value":"attachment; filename=\"test_file__results_06-16-2022.csv\""},{"key":"Allow","value":"GET"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 0e7af4d3c49480f425f8771227667e6a.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MAA51-C2"},{"key":"X-Amz-Cf-Id","value":"im28oCbWw2yEFM7VM8MupaoCSfjvkZzd4AM8jRqVDcDhk3t9eK_Jjw=="}],"cookie":[],"responseTime":null,"body":"Email,recommendation,score,rating,status,reason,threat_level,did_you_mean\r\nLoquiroz.futureleaders@gmail.com,safe_to_send,9,good,deliverable,accepted_email,undetermined,\r\ncruzing01@comcast.net,safe_to_send,10,excellent,deliverable,accepted_email,undetermined,\r\ndscheuerman1@gmail.com,safe_to_send,9,good,deliverable,accepted_email,undetermined,\r\njsteele@knoxvilletn.gov,safe_to_send,10,excellent,deliverable,accepted_email,undetermined,"},{"id":"6b3402e0-7f4a-40e5-881d-baef107a8374","name":"Not found","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"default"},{"key":"Authorization","value":"< Api-Key >","type":"default"}],"url":"https://my.alfredknows.com/api/v1/jobs/1832/download"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"text/csv"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Thu, 16 Jun 2022 09:22:46 GMT"},{"key":"Content-Disposition","value":"attachment; filename=\"test_file__results_06-16-2022.csv\""},{"key":"Allow","value":"GET"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 0e7af4d3c49480f425f8771227667e6a.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MAA51-C2"},{"key":"X-Amz-Cf-Id","value":"im28oCbWw2yEFM7VM8MupaoCSfjvkZzd4AM8jRqVDcDhk3t9eK_Jjw=="}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Not found.\"\n}"}],"_postman_id":"a30d8475-f0cc-4aa0-8b53-ac224e279404"}],"id":"1af5a49c-0d92-4a22-93af-5f60ef01b5fa","description":"The jobs API is done after the upload API, and supports two actions:
1. evaluation - it is used to determine the basic hygiene level of an uploaded file.
2. verification - provides a thoroughly cleaned file with deliverability status and reason, threat level, quality score, rating, and recommendation for each email within the uploaded file.
We recommend using a \"verification\" job prior to mailing.
\n","_postman_id":"1af5a49c-0d92-4a22-93af-5f60ef01b5fa"}],"id":"b8a72993-348f-41f3-aded-f2814cbc3521","description":"The Alfred batch APIs can be used to bulk verify multiple email addresses.
\nProcess
\nThe batch API follows a two step process:
\nOn completion of \"verification\" job, the user can download it using the GET /jobs/{id}/download. The download API also supports filtering based on score.
\nSpeed
\nDefault settings allow our customers to verify 100,000 email addresses per hour.
\nRate Limiting
\nThe batch APIs are limited to 100 requests per minute by default.
\nBatch size recommendation
\nSingle batch can process up to 150,000 emails, while recommended size would be anything between 1,000-100,000 emails.
\n","_postman_id":"b8a72993-348f-41f3-aded-f2814cbc3521"},{"name":"real-time","item":[{"name":"email-check","id":"d8de771c-ff32-49d2-9b9b-6dd85e54a6a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\", // required\r\n \"timeout\": 5, // timeout for verification (optional; default: 30)\r\n \"deliverability_status_only\": false, // optional; default: false\r\n \"threat_level_only\": false // optional; default: false\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check","urlObject":{"protocol":"https","path":["api","v1","email-check"],"host":["api","alfredknows","com"],"query":[],"variable":[]}},"response":[{"id":"4e0402af-fdfb-488d-8425-12a137220a82","name":"OK","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"scott@emailindustries.com\",\n \"score\": 8,\n \"status\": \"deliverable\",\n \"reason\": \"accepted_email\",\n \"recommendation\": \"safe_to_send\",\n \"rating\": \"good\",\n \"threat_level\": \"undetermined\",\n \"domain\": \"emailindustries.com\",\n \"provider\": \"google.com\",\n \"did_you_mean?\": null,\n \"credit_balance\": 420287\n}"},{"id":"16685a6b-ff77-4b01-ae97-2ab19eb389a0","name":"OK (Deliverability status only)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\",\r\n \"deliverability_status_only\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"87"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Mon, 27 Jun 2022 04:22:07 GMT"},{"key":"Vary","value":"Accept, Origin"},{"key":"Allow","value":"POST, GET"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 ead256cd567b3d0f8e32db9114a9d1ba.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MAA50-C2"},{"key":"X-Amz-Cf-Id","value":"LtZb5nHN7LGOfzRGZH6bf5lYYMubTGa7RAiWBvTY13564snRznO6Vw=="}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"scott@emailindustries.com\",\n \"status\": \"deliverable\",\n \"credit_balance\": 420286\n}"},{"id":"3ef2d483-5abc-4b87-a3eb-70ab21d3ffbf","name":"OK (Threat level only)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\",\r\n \"threat_level_only\": true\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"email\": \"scott@emailindustries.com\",\r\n \"threat_level\": \"undetermined\",\r\n \"credit_balance\": 420285\r\n}"},{"id":"ef8ba681-67b1-4b9e-9b1a-2b76df868161","name":"Bad Request (Insufficient credits)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Insufficient credits\"\n}"},{"id":"8c74c2ee-733c-4f7a-a65f-e5e9ce8fa3f9","name":"Bad Request (Email missing)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"timeout\": 10\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"email missing\"\n}"},{"id":"011b4516-4f9d-45b6-a940-c68760e27017","name":"Bad Request (Invalid email)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scottemailindustries.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Invalid email\"\n}"},{"id":"631ffba7-0c8d-42aa-ad9a-dde28ac1a16a","name":"Bad Request (Invalid timeout)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scottemailindustries.com\",\r\n \"timeout\": \"10\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Invalid timeout value\"\n}"},{"id":"5df2af8a-b15a-4076-8f6b-e8dd20aa2bdd","name":"Bad Request (Max timeout exceeded)","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scottemailindustries.com\",\r\n \"timeout\": 50\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Maximum supported timeout is 30 seconds\"\n}"},{"id":"0584bf80-5756-4d9d-980e-63d27ff4d24a","name":"Service Unavailable","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\" \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Try again later\"\n}"},{"id":"37a633d5-7cef-464a-b00f-6d830617d2a6","name":"Request throttled","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"< Api-Key >","type":"default"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"scott@emailindustries.com\" \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.alfredknows.com/api/v1/email-check"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Request was throttled. Expected available in 54 seconds.\"\n}"}],"_postman_id":"d8de771c-ff32-49d2-9b9b-6dd85e54a6a5"}],"id":"c662069c-12f5-468c-abc2-8cdfdcb3bc74","description":"Alfred real-time API verifies single email in real-time synchronous manner.
\nThis method is recommended when speed of verification is of a value as usually this method returns 5% more “unknown” results than full integration using batch API with verification.
\nRate Limiting
\nReal-Time Email Verification API is limited to 300 requests per minute by default. If your use case requires higher limits, please let us know.
\nNote: For optimal response, pass a timeout value higher than 5.
\n","_postman_id":"c662069c-12f5-468c-abc2-8cdfdcb3bc74"}]}