Quickstart

1. Get your API key

Create a key with POST /api/account/keys. This endpoint returns the key value when it is created, so copy it and store it securely before continuing.

See Create API Key for the authentication requirements, request body, and response format.

2. Validate your first email

The fastest way to see the API work is the Email Validity endpoint. Send an address to POST /api/email/validity and Encrata tells you whether it is safe to send to - valid, invalid, catch-all, or risky - along with the reason, provider, and domain trust signals. It is the same check you would run to scrub a list before a campaign and cut bounces. Every request authenticates with your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

curl -X POST https://developer.encrata.com/api/email/validity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "satya@microsoft.com"}'

import requests

resp = requests.post(
    "https://developer.encrata.com/api/email/validity",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"email": "satya@microsoft.com"},
)
print(resp.json())

const resp = await fetch("https://developer.encrata.com/api/email/validity", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "satya@microsoft.com" }),
});
const data = await resp.json();
console.log(data);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]string{"email": "satya@microsoft.com"})
	req, _ := http.NewRequest("POST", "https://developer.encrata.com/api/email/validity", bytes.NewBuffer(body))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&result)
	fmt.Println(result)
}

3. Read the response

A 200 OK returns the verdict plus enrichment. The two fields you will branch on are status (the public verdict) and reason (the machine-readable cause):

{
  "email": "satya@microsoft.com",
  "status": "valid",
  "reason": "deliverable",
  "disposable": false,
  "confidence": "high",
  "role": false,
  "domain": "microsoft.com",
  "provider": "microsoft",
  "free_provider": false,
  "mx": ["microsoft-com.mail.protection.outlook.com"],
  "domain_trust": { "grade": "A", "spf": true, "dmarc": true },
  "message": "Mailbox exists and accepts mail, safe to send.",
  "validity": "valid",
  "credits": 1,
  "credits_charged": 1,
  "cached": false,
  "cache_hit": false
}

Each validation costs 1 credit. Repeat checks of the same address within the billing window are free (credits: 0, cached: true). See the full field reference on the Email Validity page.

Overview

Configuration

auth.md

1. Get your API key

2. Validate your first email

3. Read the response

​1. Get your API key

​2. Validate your first email

​3. Read the response

1. Get your API key

2. Validate your first email

3. Read the response