API Overview

legacy api — sunsets june 1, 2027 this page documents the original mailfloss api, which is being retired on june 1, 2027 new integrations should use the v1 api https //developers mailfloss com/quickstart mailfloss offers a simple api enabling you to thoroughly check and verify email addresses right at the point of entry into your system in addition to checking the syntax, the actual existence of an email address using mx records, and the simple mail transfer protocol (smtp), detecting whether the requested mailbox is configured to catch all incoming email traffic, the mailfloss api also identifies role based email addresses, email addresses from free email providers, and disposable domains combined with typo checks, email address suggestions, and more, these structures will make it simple to automatically filter "real" customers from typos, spammers, abusers, and increase response and success rates of your email campaigns you can get all of this with a single api call like the following curl request get \\ \ url 'https //api mailfloss com/verify?email={email address}\&api key={api key}' recommendations treat any timeouts as unknown, and if at point of entry, allow the result to pass it is not uncommon for many smaller email hosts to take many seconds, and for this reason, the result may not come in a timely manner rather than force the user to wait, let them proceed pass a webhook url to our batch verify endpoint to avoid polling for results this is more efficient all api calls should be made server side the publicly available api is in beta the api is currently in beta and under active development while we'll make every effort to maintain consistency, updates may contain breaking changes the mailfloss email verification api allows you to add email verification to any part of your software, ideal for signup, registration, onboarding, and other points of entry you will need an api key and an account with mailfloss to use the api the api key can be generated inside of the mailfloss dashboard make api calls on the server side only the api is not suitable for use in client side scripts (e g react, angular, vue, jquery, and other javascript frameworks) because our verification endpoints do not allow cross domain requests using it directly in the browser would require exposing sensitive api credentials giving anyone access to your account please make all requests server side if you do not have access to the server side consider using our javascript widget https //developers mailfloss com/javascript widget overview instead