Skip to main content

Making API calls

This guide walks you through making your first request to the Enrichley email validation API. Whether you are new to APIs or an experienced developer, the steps below will help you integrate Enrichley quickly.

Quick start

1. Obtain your API key

  1. Log in to the Enrichley app.
  2. Sign up for a paid plan if you haven’t already.
  3. Go to your account profile and locate your API key.
  4. Copy the key and store it securely.
API keys are generated automatically when you sign up for a paid plan and can be used across all Enrichley APIs.

2. Make your first API call

Use any HTTP client (curl, Postman, your backend language, etc.) to call the single email validation endpoint:
  • URL: https://api.enrichley.io/api/v1/validate-single-email
  • Method: POST
  • Auth header: X-Api-Key: YOUR_API_KEY

3. Check the response

A 200 response always has the same eight fields. The two you need first:
  • valid is true only for ok and catch_all_validated. Only send to those addresses.
  • result says why. timeout and error are free, and you can retry them. Every other result used a credit, and retrying runs a new, charged validation.
Set your HTTP client timeout to at least 90 seconds. See Email Validation for every result, header and error.
💡 Keep your key secret: Treat your API key like a password. Never commit it to public repositories, client-side code, or share it in screenshots or support tickets.