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
- Log in to the Enrichley app.
- Sign up for a paid plan if you haven’t already.
- Go to your account profile and locate your API key.
- Copy the key and store it securely.
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
A200 response always has the same eight fields. The two you need first:
validistrueonly forokandcatch_all_validated. Only send to those addresses.resultsays why.timeoutanderrorare free, and you can retry them. Every other result used a credit, and retrying runs a new, charged validation.
💡 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.

