{"info":{"_postman_id":"677d3df8-c28c-47ad-ab45-ae21166fe426","name":"Email Validation API","description":"<html><head></head><body><h2 id=\"🚀-getting-started\">🚀 Getting started</h2>\n<p>1. <a href=\"https://maillistshield.com/app/api-keys\">Create an API key</a> on the MailListShield dashboard.</p>\n<p>2. In our Postman workspace, paste your API key at Environments &gt; MLS API Credentials &gt; API Key.</p>\n<img src=\"https://content.pstmn.io/820c827b-9c76-41bf-aa9a-f8b03c2f3b00/UlJBQ3Y1eUZNTy5wbmc=\" alt=\"Adding%20your%20API%20key%20to%20your%20Postman%20environment\">\n\n<p>3. Try out one of the requests in our collection with the 'MLS API Credentials' environment selected.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39218943","collectionId":"677d3df8-c28c-47ad-ab45-ae21166fe426","publishedId":"2sB3QDxDUr","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-09-29T07:44:37.000Z"},"item":[{"name":"Test API Key","id":"d916aee9-f74f-4d81-9019-197d7332be85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"}],"url":"https://maillistshield.com/api/test","description":"<blockquote>\n<p>Rate limit: 50 requests per hour </p>\n</blockquote>\n<p>This endpoint allows you to test if you API key is working.</p>\n<p>It forgives requests without their <code>content-type</code> header set to <code>application/json</code>, because it doesn't read your request body.</p>\n","urlObject":{"protocol":"https","path":["api","test"],"host":["maillistshield","com"],"query":[],"variable":[]}},"response":[{"id":"5b497f20-24f9-4b0f-99b8-ba9c560d5b68","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"}],"url":"https://maillistshield.com/api/test"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 05:51:50 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"197"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Hello, Cansin! Good news: your API key works.\",\n    \"note:\": \"We have not checked your content type, but for the validation endpoints, you will need to send a JSON body.\",\n    \"status\": \"success\"\n}"},{"id":"6631f35d-1f82-4a0d-82f3-56ba1a27bbda","name":"Test API Key","originalRequest":{"method":"POST","header":[],"url":"https://maillistshield.com/api/test"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 05:52:24 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"104"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"message\": \"API key is missing. Please provide an API key in the 'x-api-key' header.\",\n    \"status\": \"error\"\n}"},{"id":"cb45f6bb-8023-4ba7-ad91-ef19c965c620","name":"GET Request Attempt","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"}],"url":"https://maillistshield.com/api/test"},"status":"Method Not Allowed","code":405,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 05:57:10 GMT"},{"key":"Content-Type","value":"text/html; charset=utf-8"},{"key":"Content-Length","value":"50"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"Please use POST requests to interact with the API."}],"_postman_id":"d916aee9-f74f-4d81-9019-197d7332be85"},{"name":"Get Credit Balance","id":"8e0d83cb-3570-48b9-a931-afcf665d73bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"}],"url":"https://maillistshield.com/api/get-credit-balance","description":"<blockquote>\n<p>Rate limit: 50 requests per hour </p>\n</blockquote>\n<p>This endpoint allows you to check your credit balance.</p>\n<p>It forgives requests without their <code>content-type</code> header set to <code>application/json</code>, because it doesn't read your request body.</p>\n","urlObject":{"protocol":"https","path":["api","get-credit-balance"],"host":["maillistshield","com"],"query":[],"variable":[]}},"response":[{"id":"14338401-26c0-41c9-8632-0a4944c68ec6","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"}],"url":"https://maillistshield.com/api/get-credit-balance"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 05:48:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"87"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"balance\": 9985,\n    \"message\": \"Credit balance retrieved successfully.\",\n    \"status\": \"success\"\n}"},{"id":"ceb0ba7c-6018-4487-9539-5df19a289884","name":"Missing API Key","originalRequest":{"method":"POST","header":[],"url":"https://maillistshield.com/api/get-credit-balance"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 05:50:36 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"104"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"API key is missing. Please provide an API key in the 'x-api-key' header.\",\n    \"status\": \"error\"\n}"}],"_postman_id":"8e0d83cb-3570-48b9-a931-afcf665d73bb"},{"name":"Validate Single Email","id":"66077f22-ed5b-49c0-928b-67f285181c72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"email\":\"support@maillistshield.com\",\n    \"single_level_response\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://maillistshield.com/api/validate-email","description":"<blockquote>\n<p>Rate limit: 200 requests per hour </p>\n</blockquote>\n<p>This endpoint allows you to validate an email address.</p>\n<p>It requires a request with <code>content-type</code> header set to <code>application/json</code> and a JSON body with the following keys:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Key</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Value description</strong></th>\n<th><strong>Is Required?</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>Email address to be validated.</td>\n<td>Yes</td>\n</tr>\n<tr>\n<td>single_level_response</td>\n<td>boolean</td>\n<td>If <code>true</code>, the result is returned as a single level dictionary, which allows simpler configuration on certain email campaign platforms.  <br />  <br />Example responses are provided for both options.</td>\n<td>Optional  <br />Default: <code>false</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["api","validate-email"],"host":["maillistshield","com"],"query":[],"variable":[]}},"response":[{"id":"4b0948c8-87f6-4426-a94a-9d723ea969ac","name":"Successful Response - Single Level","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"email\":\"support@maillistshield.com\",\n    \"single_level_response\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://maillistshield.com/api/validate-email"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 06:12:52 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"792"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"account\": \"support\",\n    \"account_alias_stripped\": \"support\",\n    \"domain\": \"maillistshield\",\n    \"domain_age\": 368,\n    \"email\": \"support@maillistshield.com\",\n    \"email_alias_stripped\": \"support@maillistshield.com\",\n    \"email_provider\": \"yandex\",\n    \"email_security_gateway\": \"\",\n    \"fqdn\": \"maillistshield.com\",\n    \"has_catch_all\": false,\n    \"has_mx_records\": true,\n    \"is_alias\": false,\n    \"is_disposable\": false,\n    \"is_free_provider\": false,\n    \"is_likely_spam_trap\": false,\n    \"is_mailbox_full\": false,\n    \"is_role\": true,\n    \"is_valid_syntax\": true,\n    \"smtp_provider_host\": \"mx.yandex.net\",\n    \"smtp_provider_host_domain\": \"yandex\",\n    \"smtp_provider_host_tld\": \"net\",\n    \"smtp_provider_ip\": \"77.88.21.249\",\n    \"smtp_provider_ip_ptr\": \"mxfront.stable.qloud-b.yandex.net\",\n    \"status\": \"valid\",\n    \"status_detail\": \"email provider confirmed that the email address is deliverable\",\n    \"subdomain\": \"\",\n    \"tld\": \"com\"\n}"},{"id":"30e5ff03-cf45-46b1-a904-a3faee947a29","name":"Successful Response - Default","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"email\":\"support@maillistshield.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://maillistshield.com/api/validate-email"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 06:14:00 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"905"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Email address is validated and 1 credit is deducted from your account.\",\n    \"result\": {\n        \"account\": \"support\",\n        \"account_alias_stripped\": \"support\",\n        \"domain\": \"maillistshield\",\n        \"domain_age\": 368,\n        \"email\": \"support@maillistshield.com\",\n        \"email_alias_stripped\": \"support@maillistshield.com\",\n        \"email_provider\": \"yandex\",\n        \"email_security_gateway\": \"\",\n        \"fqdn\": \"maillistshield.com\",\n        \"has_catch_all\": false,\n        \"has_mx_records\": true,\n        \"is_alias\": false,\n        \"is_disposable\": false,\n        \"is_free_provider\": false,\n        \"is_likely_spam_trap\": false,\n        \"is_mailbox_full\": false,\n        \"is_role\": true,\n        \"is_valid_syntax\": true,\n        \"smtp_provider_host\": \"mx.yandex.net\",\n        \"smtp_provider_host_domain\": \"yandex\",\n        \"smtp_provider_host_tld\": \"net\",\n        \"smtp_provider_ip\": \"77.88.21.249\",\n        \"smtp_provider_ip_ptr\": \"mxfront.stable.qloud-b.yandex.net\",\n        \"status\": \"valid\",\n        \"status_detail\": \"email provider confirmed that the email address is deliverable\",\n        \"subdomain\": \"\",\n        \"tld\": \"com\"\n    },\n    \"status\": \"success\"\n}"},{"id":"f1408fa4-7b34-44d5-a1a8-fd6b2088490f","name":"Invalid API Key","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{API_KEY}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"email\":\"support@maillistshield.com\",\n    \"single_level_response\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://maillistshield.com/api/validate-email"},"status":"Forbidden","code":403,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 06:12:28 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"48"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Invalid API key.\",\n    \"status\": \"error\"\n}"},{"id":"962d150c-36c0-457a-9673-e7c46fab4fb9","name":"Missing API Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"email\":\"support@maillistshield.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://maillistshield.com/api/validate-email"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Mon, 29 Sep 2025 06:15:05 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"104"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://maillistshield.com"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"API key is missing. Please provide an API key in the 'x-api-key' header.\",\n    \"status\": \"error\"\n}"}],"_postman_id":"66077f22-ed5b-49c0-928b-67f285181c72"}],"event":[{"listen":"prerequest","script":{"id":"a8f3b7f5-14c3-4385-a4a6-abbe1fe77397","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"b6453c75-ca83-4f24-863e-77f17989ce9a","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}]}