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
- Sign up or log in at apivult.com
- Subscribe to any APIVult API (free tier available)
- Copy your
X-API-Keyfrom 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
| Status | Error | Cause |
|---|---|---|
401 | Unauthorized | Missing or invalid X-API-Key |
403 | Forbidden | Key valid but not subscribed to this API |
429 | Too Many Requests | Rate limit exceeded for your plan |