Docs
Authentication

Authentication

How to authenticate with APIVult APIs using your API key.

All APIVult APIs use API key authentication. You must include your API key in every request.

Getting Your API Key

  1. Sign up or log in at apivult.com
  2. Subscribe to any APIVult API (free tier available)
  3. Copy your X-API-Key from the APIVult dashboard

Making Authenticated Requests

Include your key in the request headers:

curl -X POST https://api.apivult.com/v1/dev/dataforge/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"type": "email", "value": "[email protected]"}'

Python

import requests
 
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
}
 
response = requests.post(
    "https://api.apivult.com/v1/dev/dataforge/validate",
    headers=headers,
    json={"type": "email", "value": "[email protected]"},
)
print(response.json())

Node.js

const response = await fetch("https://api.apivult.com/v1/dev/dataforge/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
  body: JSON.stringify({ type: "email", value: "[email protected]" }),
});
const data = await response.json();

Security Best Practices

  • Never expose your API key in client-side code, public repositories, or logs
  • Store your key in environment variables (e.g., APIVULT_API_KEY)
  • Rotate your key immediately if it is ever compromised via the APIVult dashboard
  • Use server-side proxies when calling APIs from browser-based applications

Authentication Errors

StatusErrorCause
401UnauthorizedMissing or invalid X-API-Key
403ForbiddenKey valid but not subscribed to this API
429Too Many RequestsRate limit exceeded for your plan