Skip to main content

​
API Key Authentication

The Huntd API uses API keys for authentication. All requests must include your API key in the X-API-Key header.

​
API Key Format

hntd_{id}_{secret}
Example: hntd_abc12345_xK9mN2pQ4rS7tU0vW3xY
Keep your API key secret. Never expose it in client-side code or public repositories.

​
Making Requests

curl -X POST https://api.gethuntd.com/api/v1/external/verify-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey" \
  -d '{"email": "[email protected]"}'

​
Obtaining an API Key

Contact your organization administrator to get an API key.
API keys are shown only once when created. If you lose your key, request a new one.

​
Security Best Practices

  • Store API keys in environment variables
  • Never commit keys to version control
  • Only make API calls from server-side code
  • Monitor usage for unexpected activity

​
Authentication Errors

Error CodeHTTP StatusDescription
INVALID_API_KEY401API key is missing, invalid, malformed, or disabled