{"id":2680,"date":"2025-07-17T13:05:51","date_gmt":"2025-07-17T13:05:51","guid":{"rendered":"https:\/\/mailerio.com\/?page_id=2680"},"modified":"2025-08-04T12:32:07","modified_gmt":"2025-08-04T12:32:07","slug":"api-reference","status":"publish","type":"page","link":"https:\/\/mailerio.com\/docs\/api-reference\/","title":{"rendered":"API Reference"},"content":{"rendered":"<div>\n<link href=\"https:\/\/fonts.googleapis.com\/css?family=Montserrat:300,400,700|Roboto:300,400,700\" rel=\"stylesheet\">\n<style>\n    .menu-content {top: 90px !important}\n    .eVrqat {padding: 20px 0px}\n<\/style>\n<div id=\"docs\">\n      <redoc spec-url=\"https:\/\/api.mailerio.com\/swagger\/v1\/swagger.json\" hide-download-button><\/redoc><br \/>\n      <script src=\"https:\/\/cdn.redoc.ly\/redoc\/latest\/bundles\/redoc.standalone.js\"> <\/script>\n<\/div>\n<h1>Test email addresses without spending credits<\/h1>\n<ul>\n<li>\n<div>deliverable@mailerio.com | Status = <u>deliverable<\/u><\/div>\n<\/li>\n<li>\n<div>undeliverable@mailerio.com | Status = <u>undeliverable<\/u><\/div>\n<\/li>\n<li>\n<div>risky@mailerio.com | Status = <u>risky<\/u><\/div>\n<\/li>\n<li>\n<div>unknown@mailerio.com | Status = <u>unknown<\/u><\/div>\n<\/li>\n<li>\n<div>role@mailerio.com | role = <u>true<\/u><\/div>\n<\/li>\n<li>\n<div>free@mailerio.com | free = <u>true<\/u><\/div>\n<\/li>\n<li>\n<div>acceptall@mailerio.com | acceptall = <u>true<\/u><\/div>\n<\/li>\n<li>\n<div>disposable@mailerio.com | disposable = <u>true<\/u><\/div>\n<\/li>\n<\/ul>\n<h1>API Limits<\/h1>\n<div>\n<div>5 requests \/ second for all API endpoints. Contact support to increase rate limits.<\/div>\n<\/div>\n<p><!--more--><br \/>\n<!-- {\"type\":\"layout\",\"children\":[{\"type\":\"section\",\"props\":{\"image_position\":\"center-center\",\"style\":\"default\",\"title_breakpoint\":\"xl\",\"title_position\":\"top-left\",\"title_rotation\":\"left\",\"vertical_align\":\"middle\",\"width\":\"default\"},\"children\":[{\"type\":\"row\",\"props\":{\"layout\":\"1-4,3-4\",\"status\":\"disabled\"},\"children\":[{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\",\"width_medium\":\"1-4\"},\"children\":[{\"type\":\"module\",\"props\":{\"menu_image_align\":\"center\",\"menu_image_margin\":true,\"menu_style\":\"default\",\"menu_type\":\"nav\",\"type\":\"custom_html\",\"widget\":\"custom_html-5\"}}]},{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\",\"width_medium\":\"3-4\"},\"children\":[{\"type\":\"html\",\"props\":{\"content\":\"\n\n<h3 class=\\\"uk-margin-remove uk-padding-remove\\\">Validate List Of Email Addresses<\\\/h3>\\n\n\n<div><span class=\\\"uk-badge uk-background-primary uk-margin-xsmall-right\\\">GET<\\\/span><span class=\\\"uk-text-meta\\\">https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate<\\\/span><\\\/div>\"}},{\"type\":\"fragment\",\"props\":{\"margin\":\"default\"},\"children\":[{\"type\":\"row\",\"props\":{\"layout\":\"1-2,1-2\"},\"children\":[{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\",\"width_medium\":\"1-2\"},\"children\":[{\"type\":\"html\",\"props\":{\"content\":\"\n\n<div class=\\\"uk-panel\\\">\\n\n\n<h6 class=\\\"uk-margin-top uk-text-lead\\\">Query parameters<\\\/h6>\\n\n\n<dl class=\\\"uk-description-list uk-border\\\">\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">email<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><span class=\\\"uk-text-meta uk-text-danger\\\">required<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The email address to be validated, as a URL-encoded string.<\\\/span><\\\/dd>\\n<\\\/dl>\\n\n\n<dl class=\\\"uk-description-list\\\">\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">api_key<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><span class=\\\"uk-text-meta uk-text-danger\\\">required<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The email address to be validated, as a URL-encoded string.<\\\/span><\\\/dd>\\n<\\\/dl>\\n<\\\/div>\\n\\n\n\n<hr \\\/>\\n\\n\n\n<div class=\\\"uk-panel\\\">\\n  \n\n<h6 class=\\\"uk-margin-top uk-text-lead\\\">Response Parameters<\\\/h6>\\n  \n\n<dl class=\\\"uk-description-list uk-border\\\">\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">created<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string (ISO 8601)<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Date and time when the validation was processed (UTC).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">email<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The email address being validated.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">user<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The local part (username) of the email address.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">domain<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The domain part of the email address.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">acceptAll<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Indicates if the domain appears to accept all emails (catch-all).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">disposable<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Indicates if the email address is disposable (temporary).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">duration<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">number (seconds)<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Time taken to process the validation.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">free<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">True if the email provider is free (e.g., Gmail, Yahoo).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">mailboxFull<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean or null<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">True if the recipient's mailbox is full; null if unknown.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">mxRecord<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Primary MX (mail exchange) record for the domain.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">noReply<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">True if the address appears to be a \\\"no-reply\\\" or automated inbox.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">role<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">True if the email is a role-based address (e.g., admin@, support@).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">score<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">number<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Score for deliverability or quality; interpretation may vary.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">smtpProvider<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Identified SMTP service provider for the domain.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">status<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Overall status of the email validation (\\\"deliverable\\\", \\\"undeliverable\\\", etc.).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">reason<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Reason for the current status (e.g., \\\"rejected_email\\\").<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">isValid<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">boolean<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">True if the email is considered valid\\\/deliverable.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">tag<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">string or null<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">The tagged portion of the email address (if any, e.g., plus-addressing); null if none.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">validationLevel<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">number<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Level of validation performed (higher means more thorough, see API docs for levels).<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">creditsUsed<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">integer<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">How many credits (API validation units) were used for this request.<\\\/span><\\\/dd>\\n\\n    \n\n<dt><span class=\\\"uk-margin-xsmall-right\\\">balance<\\\/span><span class=\\\"uk-margin-xsmall-right uk-text-meta\\\">integer<\\\/span><\\\/dt>\\n    \n\n<dd><span class=\\\"uk-text-meta\\\">Remaining API credit balance after this validation.<\\\/span><\\\/dd>\\n  <\\\/dl>\\n<\\\/div>\"}}]},{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\",\"width_medium\":\"1-2\"},\"children\":[{\"type\":\"html\",\"props\":{\"content\":\"\n\n<ul class=\\\"uk-subnav uk-subnav-pill\\\" uk-switcher>\\n    \n\n<li><a href=\\\"#\\\">HTTP<\\\/a><\\\/li>\\n    \n\n<li><a href=\\\"#\\\">.NET<\\\/a><\\\/li>\\n    \n\n<li><a href=\\\"#\\\">JS<\\\/a><\\\/li>\\n    \n\n<li><a href=\\\"#\\\">Python<\\\/a><\\\/li>\\n    \n\n<li><a href=\\\"#\\\">PHP<\\\/a><\\\/li>\\n<\\\/ul>\\n\\n\n\n<div class=\\\"uk-switcher uk-margin\\\">\\n    \n\n<div>\\n        \n\n<pre>GET https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate?email={email}&api_key={apikey}<\\\/pre>\\n    <\\\/div>\\n    \n\n<div>\\n        \n\n<pre>using var client = new HttpClient();\\nvar email = \\\"test@example.com\\\";\\nvar apiKey = \\\"YOUR_API_KEY\\\";\\nvar url = $\\\"https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate?email={Uri.EscapeDataString(email)}&api_key={Uri.EscapeDataString(apiKey)}\\\";\\nvar result = await client.GetStringAsync(url);<\\\/pre>\\n    <\\\/div>\\n    \n\n<div>\\n        \n\n<pre>var email = \\\"test@example.com\\\";\\nvar apiKey = \\\"YOUR_API_KEY\\\";\\nvar url = \\\"https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate?email=\\\" + \\n    encodeURIComponent(email) + \\n    \\\"&api_key=\\\" + \\n    encodeURIComponent(apiKey);\\n\\nvar xhr = new XMLHttpRequest();\\nxhr.open(\\\"GET\\\", url);\\nxhr.onload = function () {\\n    console.log(xhr.responseText);\\n};\\nxhr.onerror = function () {\\n    console.error(\\\"Request failed\\\");\\n};\\nxhr.send();<\\\/pre>\\n    <\\\/div>\\n    \n\n<div>\\n        \n\n<pre>import urllib.parse\\nimport urllib.request\\n\\nemail = \\\"test@example.com\\\"\\napi_key = \\\"YOUR_API_KEY\\\"\\nurl = f\\\"https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate?email={urllib.parse.quote(email)}&api_key={urllib.parse.quote(api_key)}\\\"\\n\\nwith urllib.request.urlopen(url) as response:\\n    print(response.read().decode())<\\\/pre>\\n    <\\\/div>\\n    \n\n<div>\\n        \n\n<pre>$email = \\\"test@example.com\\\";\\n$apiKey = \\\"YOUR_API_KEY\\\";\\n$url = \\\"https:\\\/\\\/api.mailerio.com\\\/v1\\\/validate?email=\\\" . urlencode($email) . \\\"&api_key=\\\" . urlencode($apiKey);\\n$response = file_get_contents($url);\\necho $response;<\\\/pre>\\n    <\\\/div>\\n<\\\/div>\\n\\n\n\n<div class=\\\"uk-panel\\\">\\n    \n\n<h6>Response<\\\/h6>\\n    \n\n<pre>\\n    {\\n        \\\"created\\\": \\\"2025-07-17T11:44:33.6847071Z\\\",\\n        \\\"email\\\": \\\"john.doe@gmail.com\\\",\\n        \\\"user\\\": \\\"john.doe\\\",\\n        \\\"domain\\\": \\\"gmail.com\\\",\\n        \\\"acceptAll\\\": false,\\n        \\\"disposable\\\": false,\\n        \\\"duration\\\": 0.203,\\n        \\\"free\\\": true,\\n        \\\"mailboxFull\\\": null,\\n        \\\"mxRecord\\\": \\\"gmail-smtp-in.l.google.com\\\",\\n        \\\"noReply\\\": false,\\n        \\\"role\\\": false,\\n        \\\"score\\\": 0,\\n        \\\"smtpProvider\\\": \\\"google\\\",\\n        \\\"status\\\": \\\"undeliverable\\\",\\n        \\\"reason\\\": \\\"rejected_email\\\",\\n        \\\"isValid\\\": false,\\n        \\\"tag\\\": null,\\n        \\\"validationLevel\\\": 3,\\n        \\\"creditsUsed\\\": 1,\\n        \\\"balance\\\": 89\\n    }\\n    <\\\/pre>\\n<\\\/div>\"}}]}]}]}]}]}]},{\"type\":\"section\",\"props\":{\"image_position\":\"center-center\",\"padding\":\"none\",\"style\":\"default\",\"title_breakpoint\":\"xl\",\"title_position\":\"top-left\",\"title_rotation\":\"left\",\"vertical_align\":\"middle\",\"width\":\"expand\"},\"children\":[{\"type\":\"row\",\"children\":[{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\"},\"children\":[{\"type\":\"html\",\"props\":{\"content\":\"<link href=\\\"https:\\\/\\\/fonts.googleapis.com\\\/css?family=Montserrat:300,400,700|Roboto:300,400,700\\\" rel=\\\"stylesheet\\\">\\n\n\n<style>\\n    .menu-content {top: 90px !important}\\n    .eVrqat {padding: 20px 0px}\\n<\\\/style>\\n  \n\n<div id=\\\"docs\\\">\\n      <redoc spec-url=\\\"https:\\\/\\\/api.mailerio.com\\\/swagger\\\/v1\\\/swagger.json\\\" hide-download-button><\\\/redoc>\\n      <script src=\\\"https:\\\/\\\/cdn.redoc.ly\\\/redoc\\\/latest\\\/bundles\\\/redoc.standalone.js\\\"> <\\\/script>\"}}]}],\"props\":{\"margin\":\"remove-vertical\",\"width\":\"expand\"}}]},{\"type\":\"section\",\"props\":{\"image_position\":\"center-center\",\"style\":\"default\",\"title_breakpoint\":\"xl\",\"title_position\":\"top-left\",\"title_rotation\":\"left\",\"vertical_align\":\"middle\",\"width\":\"default\"},\"children\":[{\"type\":\"row\",\"children\":[{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\"},\"children\":[{\"type\":\"headline\",\"props\":{\"content\":\"Test email addresses without spending credits\",\"title_element\":\"h1\",\"title_style\":\"h4\"}},{\"type\":\"list\",\"props\":{\"column_breakpoint\":\"m\",\"image_align\":\"left\",\"image_svg_color\":\"emphasis\",\"image_vertical_align\":true,\"list_element\":\"ul\",\"list_horizontal_separator\":\", \",\"list_marker\":\"bullet\",\"list_style\":\"divider\",\"list_type\":\"vertical\",\"show_image\":true,\"show_link\":true},\"children\":[{\"type\":\"list_item\",\"props\":{\"content\":\"deliverable@mailerio.com | Status = <u>deliverable<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"undeliverable@mailerio.com | Status = <u>undeliverable<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"risky@mailerio.com | Status = <u>risky<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"unknown@mailerio.com | Status = <u>unknown<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"role@mailerio.com | role = <u>true<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"free@mailerio.com | free = <u>true<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"acceptall@mailerio.com | acceptall = <u>true<\\\/u>\"}},{\"type\":\"list_item\",\"props\":{\"content\":\"disposable@mailerio.com | disposable = <u>true<\\\/u>\"}}]}]}]}]},{\"type\":\"section\",\"props\":{\"image_position\":\"center-center\",\"style\":\"default\",\"title_breakpoint\":\"xl\",\"title_position\":\"top-left\",\"title_rotation\":\"left\",\"vertical_align\":\"middle\",\"width\":\"default\"},\"children\":[{\"type\":\"row\",\"children\":[{\"type\":\"column\",\"props\":{\"image_position\":\"center-center\",\"position_sticky_breakpoint\":\"m\"},\"children\":[{\"type\":\"headline\",\"props\":{\"content\":\"API Limits\",\"title_element\":\"h1\",\"title_style\":\"h4\"}},{\"type\":\"list\",\"props\":{\"column_breakpoint\":\"m\",\"image_align\":\"left\",\"image_svg_color\":\"emphasis\",\"image_vertical_align\":true,\"list_element\":\"ul\",\"list_horizontal_separator\":\", \",\"list_marker\":\"bullet\",\"list_style\":\"divider\",\"list_type\":\"vertical\",\"show_image\":true,\"show_link\":true},\"children\":[{\"type\":\"list_item\",\"props\":{\"content\":\"5 requests \\\/ second for all API endpoints. Contact support to increase rate limits.\"}}]}]}]}]}],\"version\":\"4.5.15\"} --><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Test email addresses without spending credits deliverable@mailerio.com | Status = deliverable undeliverable@mailerio.com | Status = undeliverable risky@mailerio.com | Status = risky unknown@mailerio.com | Status = unknown role@mailerio.com | role = true free@mailerio.com | free = true acceptall@mailerio.com | acceptall = true disposable@mailerio.com | disposable = true API Limits 5 requests \/ second for all API [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2674,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2680","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API Reference - Mailerio<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/mailerio.com\/docs\/api-reference\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Reference - Mailerio\" \/>\n<meta property=\"og:description\" content=\"Test email addresses without spending credits deliverable@mailerio.com | Status = deliverable undeliverable@mailerio.com | Status = undeliverable risky@mailerio.com | Status = risky unknown@mailerio.com | Status = unknown role@mailerio.com | role = true free@mailerio.com | free = true acceptall@mailerio.com | acceptall = true disposable@mailerio.com | disposable = true API Limits 5 requests \/ second for all API [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/mailerio.com\/docs\/api-reference\/\" \/>\n<meta property=\"og:site_name\" content=\"Mailerio\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-04T12:32:07+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/mailerio.com\\\/docs\\\/api-reference\\\/\",\"url\":\"https:\\\/\\\/mailerio.com\\\/docs\\\/api-reference\\\/\",\"name\":\"API Reference - Mailerio\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/mailerio.com\\\/#website\"},\"datePublished\":\"2025-07-17T13:05:51+00:00\",\"dateModified\":\"2025-08-04T12:32:07+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/mailerio.com\\\/docs\\\/api-reference\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/mailerio.com\\\/docs\\\/api-reference\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/mailerio.com\\\/docs\\\/api-reference\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/mailerio.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/mailerio.com\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API Reference\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/mailerio.com\\\/#website\",\"url\":\"https:\\\/\\\/mailerio.com\\\/\",\"name\":\"Mailerio\",\"description\":\"Email Validation & Verifier Tool\",\"publisher\":{\"@id\":\"https:\\\/\\\/mailerio.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/mailerio.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/mailerio.com\\\/#organization\",\"name\":\"Mailerio\",\"url\":\"https:\\\/\\\/mailerio.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/mailerio.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/mailerio.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/Mailerio-white-backgroundV4.png\",\"contentUrl\":\"https:\\\/\\\/mailerio.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/Mailerio-white-backgroundV4.png\",\"width\":350,\"height\":350,\"caption\":\"Mailerio\"},\"image\":{\"@id\":\"https:\\\/\\\/mailerio.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/company\\\/mailerio-com\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API Reference - Mailerio","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/mailerio.com\/docs\/api-reference\/","og_locale":"en_US","og_type":"article","og_title":"API Reference - Mailerio","og_description":"Test email addresses without spending credits deliverable@mailerio.com | Status = deliverable undeliverable@mailerio.com | Status = undeliverable risky@mailerio.com | Status = risky unknown@mailerio.com | Status = unknown role@mailerio.com | role = true free@mailerio.com | free = true acceptall@mailerio.com | acceptall = true disposable@mailerio.com | disposable = true API Limits 5 requests \/ second for all API [&hellip;]","og_url":"https:\/\/mailerio.com\/docs\/api-reference\/","og_site_name":"Mailerio","article_modified_time":"2025-08-04T12:32:07+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/mailerio.com\/docs\/api-reference\/","url":"https:\/\/mailerio.com\/docs\/api-reference\/","name":"API Reference - Mailerio","isPartOf":{"@id":"https:\/\/mailerio.com\/#website"},"datePublished":"2025-07-17T13:05:51+00:00","dateModified":"2025-08-04T12:32:07+00:00","breadcrumb":{"@id":"https:\/\/mailerio.com\/docs\/api-reference\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/mailerio.com\/docs\/api-reference\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/mailerio.com\/docs\/api-reference\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/mailerio.com\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/mailerio.com\/docs\/"},{"@type":"ListItem","position":3,"name":"API Reference"}]},{"@type":"WebSite","@id":"https:\/\/mailerio.com\/#website","url":"https:\/\/mailerio.com\/","name":"Mailerio","description":"Email Validation & Verifier Tool","publisher":{"@id":"https:\/\/mailerio.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/mailerio.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/mailerio.com\/#organization","name":"Mailerio","url":"https:\/\/mailerio.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/mailerio.com\/#\/schema\/logo\/image\/","url":"https:\/\/mailerio.com\/wp-content\/uploads\/2025\/06\/Mailerio-white-backgroundV4.png","contentUrl":"https:\/\/mailerio.com\/wp-content\/uploads\/2025\/06\/Mailerio-white-backgroundV4.png","width":350,"height":350,"caption":"Mailerio"},"image":{"@id":"https:\/\/mailerio.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/mailerio-com\/"]}]}},"_links":{"self":[{"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/pages\/2680","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/comments?post=2680"}],"version-history":[{"count":25,"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/pages\/2680\/revisions"}],"predecessor-version":[{"id":2728,"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/pages\/2680\/revisions\/2728"}],"up":[{"embeddable":true,"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/pages\/2674"}],"wp:attachment":[{"href":"https:\/\/mailerio.com\/wp-json\/wp\/v2\/media?parent=2680"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}