---
title: Code Examples
slug: email-verification-code-examples
docTags: 
createdAt: 2026-06-16T03:07:41.730Z
---

:::hint{type="warning"}
## 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).
:::

## Single verification endpoint

```shell
curl --request GET \
  --url 'https://api.mailfloss.com/verify?email={email_address}&api_key={api_key}'
```

## Batch verification endpoint

```shell
curl -X POST \
  --url https://api.mailfloss.com/batch-verify?api_key={api_key} \
  -d '{"emails":["email_address1", "email_address2"]}' -H "Content-Type: application/json"
```

## Get batch verification job status

```shell
curl --request GET \
  --url 'https://api.mailfloss.com/batch-verify/{id}/status?api_key={api_key}'
```

## Get batch verification results of completed job

```shell
curl --request GET \
  --url 'https://api.mailfloss.com/batch-verify/{id}?api_key={api_key}'
```
