Authentication overview

Verifier provides an API for real-time and bulk email validation, essential for maintaining clean email lists and reducing bounce rates. Access to the Verifier API is secured through the use of API keys. These keys serve as the primary method for authenticating requests, ensuring that only authorized users and applications can utilize the service. The API key must be included with every request to the Verifier API to validate the calling client's identity and permissions. This approach simplifies integration while maintaining a necessary level of security for API access.

Using API keys is a common practice for many web services, offering a balance between ease of use and security. For instance, services like Stripe Payments and Twilio also utilize API keys for authenticating requests to their respective platforms, demonstrating its widespread adoption and effectiveness in controlling API access Stripe API keys documentation and Twilio's explanation of API keys. Verifier's implementation follows similar principles, requiring clients to manage their API keys securely.

Supported authentication methods

Verifier exclusively supports API key authentication for accessing its services. This method involves generating a unique string (the API key) from your Verifier account dashboard, which then needs to be passed with each API request. The API key identifies your account and authorizes the request to perform email validation tasks.

The table below summarizes the supported authentication method:

Method When to Use Security Level
API Key All API interactions for real-time and bulk email validation. Moderate (Requires secure key management and HTTPS).

API keys are typically transmitted via HTTP headers or as a query parameter, though headers are generally preferred for security reasons to prevent the key from being logged in server access logs or browser history Verifier API reference. Verifier's documentation specifies the exact method for including the API key in requests.

Getting your credentials

To obtain your Verifier API key, you need to register for an account on the Verifier website. Once registered and logged in, your API key will be available in your account dashboard. Follow these general steps:

  1. Sign Up or Log In: Navigate to the Verifier homepage and either create a new account or log in to an existing one.
  2. Access Dashboard: After logging in, you will typically be redirected to your user dashboard.
  3. Locate API Key Section: Look for a section labeled 'API Key', 'Developer Settings', or similar. The exact location may vary, but it is usually prominent within the dashboard's developer or settings area.
  4. Retrieve Key: Your unique API key will be displayed. It is crucial to treat this key as a sensitive credential.

Verifier offers a free tier that includes 100 free verifications, allowing developers to test the API and retrieve their API key without an initial financial commitment. For detailed instructions, refer to the official Verifier documentation.

Authenticated request example

An authenticated request to the Verifier API typically involves sending an HTTP GET or POST request to a specific endpoint, including your API key. The API key is generally passed as a query parameter or within a custom HTTP header, as specified in the Verifier API documentation. The following example demonstrates a common way to make a real-time email verification request using cURL, assuming the API key is passed as a query parameter named key and the email to verify is email_address:

curl -X GET \
  'https://api.verifier.me/v2/[email protected]&key=YOUR_API_KEY' \
  -H 'Content-Type: application/json'

In this example:

  • https://api.verifier.me/v2/verify is the API endpoint for real-time email verification.
  • [email protected] is the email address you want to verify.
  • key=YOUR_API_KEY is where you replace YOUR_API_KEY with the actual API key obtained from your Verifier dashboard.
  • -H 'Content-Type: application/json' specifies the content type for the request.

It's important to consult the Verifier API reference for the most up-to-date and specific instructions on endpoint URLs, required parameters, and how to correctly include your API key for different API calls (e.g., bulk verification vs. real-time validation).

For developers using specific programming languages, Verifier's documentation often includes code examples. For instance, a Python example might look like this:

import requests

api_key = "YOUR_API_KEY"
email_to_verify = "[email protected]"
url = f"https://api.verifier.me/v2/verify?email={email_to_verify}&key={api_key}"

response = requests.get(url)
data = response.json()

print(data)

This Python snippet performs the same GET request, demonstrating how to construct the URL with the API key and process the JSON response. Always refer to the official Verifier documentation for examples in your preferred language, which may include Node.js, PHP, Ruby, Go, Java, and more.

Security best practices

Securing your API keys is paramount to protect your Verifier account and prevent unauthorized usage. Adhering to these best practices helps mitigate common security risks:

  • Keep API Keys Confidential: Never hardcode API keys directly into public client-side code (e.g., JavaScript in a web browser). Instead, use environment variables, secure configuration files, or a secrets management service to store and access keys on the server-side.
  • Use HTTPS/TLS: Always ensure that all communications with the Verifier API are conducted over HTTPS (HTTP Secure). This encrypts the data in transit, protecting your API key and other sensitive information from interception. Verifier's API endpoints are secured with TLS, but it's your responsibility to ensure your client applications also use HTTPS.
  • Restrict Key Permissions (if applicable): While Verifier API keys generally grant access to all email validation functions for your account, if Verifier were to introduce granular permissions in the future, always configure your keys with the minimum necessary permissions required for the specific tasks they perform.
  • Rotate API Keys Regularly: Periodically generate new API keys and deprecate old ones. This practice reduces the window of opportunity for a compromised key to be exploited. Many services recommend rotating API keys every 90 days or less.
  • Monitor Usage: Regularly check your Verifier account's API usage statistics for any unusual activity. Spikes in usage or unexpected calls could indicate a compromised key.
  • Implement IP Whitelisting (if available): If Verifier provides an option to whitelist specific IP addresses for API key usage, enable this feature. This restricts API key usage to requests originating from known, trusted servers, significantly reducing the risk of unauthorized access.
  • Error Handling and Logging: Implement robust error handling in your applications to manage API communication failures gracefully. Avoid logging API keys in plain text within application logs.
  • Secure Development Practices: Follow general secure coding principles, such as input validation and protection against common web vulnerabilities (e.g., SQL injection, cross-site scripting), to prevent attackers from gaining access to your API keys through your application.

By diligently following these security guidelines, developers can effectively protect their Verifier API keys and ensure the secure operation of their email validation integrations. For further details on securing API keys, resources like the Google Cloud documentation on API key best practices offer comprehensive guidance applicable to many API services.