> For the complete documentation index, see [llms.txt](https://docs.acychecker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acychecker.com/api-documentation/api-single-email-check.md).

# Check a single email address

## Single email check

<mark style="color:blue;">`GET`</mark> `https://api.acychecker.com/api/v1/email_verify/{email}`

This endpoint allows you to test an email address and get the results.&#x20;

#### Path Parameters

| Name                                    | Type   | Description                         |
| --------------------------------------- | ------ | ----------------------------------- |
| email<mark style="color:red;">\*</mark> | string | The email address you want to check |

#### Headers

| Name                                           | Type   | Description                |
| ---------------------------------------------- | ------ | -------------------------- |
| API-KEY<mark style="color:red;">\*</mark>      | string | Your API key               |
| Content-Type<mark style="color:red;">\*</mark> | string | Must be "application/json" |

{% tabs %}
{% tab title="200 The check results are returned in a data element." %}

```
{
    "message": "",
    "data": {
        "email": "email@example.com",
        "valid": true,
        "disposable": false,
        "free": true,
        "role": false,
        "d_exists": true,
        "exists": "valid",
        "accept_all": false
    }
}
```

{% endtab %}

{% tab title="401 When the API key provided doesn't exist, or if the license is expired." %}

```
{
    "message": "Invalid API-KEY"
}

OR

{
    "message": "License expired"
}
```

{% endtab %}

{% tab title="403 When you exceeded the monthly credits for the provided API key." %}

```
{
    "message": "No credits left",
    "data": []
}
```

{% endtab %}

{% tab title="429 When you've sent a lot of requests to our API in a short amount of time." %}

```
{
    "message": "Too many requests"
}
```

{% endtab %}
{% endtabs %}