API Reference

Haal SMTP-instellingen op via HTTP. Authenticatie via API key verplicht.

Endpoint

GET https://lookup.espos.nl/api/lookup?email={email}

Authenticatie

Stuur de API key mee als header:

X-API-Key: sk_<jouw-key>

API keys zijn aan te maken via het beheerpaneel op /admin.

Parameters

ParameterVerplichtOmschrijving
email ja Het e-mailadres om op te zoeken.
force nee Stel in op 1 om de cache te omzeilen en opnieuw op te zoeken.

Response

{
  "domain":  "bedrijf.nl",
  "source":  "autoconfig",       // autoconfig · autodiscover · database · custom · mx_record
  "cached":  false,
  "cache_ttl": 86012,            // resterende cache-tijd in seconden
  "smtp": {
    "host":            "smtp.bedrijf.nl",
    "port":            587,
    "encryption":      "STARTTLS",  // SSL · STARTTLS · none
    "username_format": "email"       // "email" = volledig adres, "localpart" = alleen gebruikersnaam
  }
}

Opzoeklagen

BronOmschrijvingCache TTL
autoconfig Mozilla Autoconfig XML op het domein zelf. 24 uur
autodiscover Microsoft Autodiscover XML (Outlook-formaat). 24 uur
vaste database Bekende providers (Gmail, Outlook, Ziggo, etc.). 7 dagen
handmatig Handmatig ingevoerd via het beheerpaneel. geen cache
MX record Fallback via DNS MX record. Kan een schatting zijn (is_guess: true). 6 uur

Voorbeelden

Standaard lookup:

curl -H "X-API-Key: sk_..." \
  "https://lookup.espos.nl/api/lookup?email=info@bedrijf.nl"

Cache omzeilen (force refresh):

curl -H "X-API-Key: sk_..." \
  "https://lookup.espos.nl/api/lookup?email=info@bedrijf.nl&force=1"