Your first email detection check

This walkthrough takes you from a dashboard key to a successful detect response. Deep field semantics live in the email detection overview.

1. Create an API key

1. Select the team that should own the integration.
2. Open Team → API keys (or follow Creating API keys).
3. Create a key that includes the email:detect scope.
4. Copy the secret immediately — it is shown only once.

Scope reference: API key scopes.

2. Call the detect endpoint

curl -sS -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.emailguard.co/api/v1/emails/detect?email=user%40example.com"

Use your real API host if it differs. Prefer an official SDK client in production.

3. Read the response

A successful response includes syntax validation, a normalized address, and boolean flags such as disposable, role, public domain, and relay. Full schema: Detect email characteristics.

4. Handle limits

• 429 — back off using Retry-After. See API rate limiting.
• Monthly quota — successful detects count toward the team's plan when billing is enabled. Check Billing usage.

Next

• Signup patterns: Block disposable emails at signup
• Dashboard vs API: Integrating from the dashboard