Authentication

API Key Authentication

Include your API key in the request header:

HTTP Header

Authorization: Bearer your_api_key_here

-H "Authorization: Bearer $API_KEY" \

Getting Your API Key

Sign Up: Create an account at VeriRoute Intel
Verify Email: Check your email and verify your account
Access Dashboard: Log in to your dashboard
Generate Key: Go to API Keys and create a new key
Copy Key: Save your API key securely - it won't be shown again

Security Best Practices

⚠️ Keep Your API Key Secure

Your API key provides access to your account and data. Never share it publicly or commit it to version control.

Recommended Practices

Environment Variables: Store API keys in environment variables, not in code
Rotate Keys: Regularly rotate your API keys (monthly or quarterly)
Restrict Access: Use separate keys for different applications or environments
Monitor Usage: Regularly check your API usage in the dashboard
HTTPS Only: Always use HTTPS when making API requests

Authentication Examples

cURL

# Using environment variable
export API_KEY="your_api_key_here"

# Around line 106 - cURL example
curl -X POST https://api-service.verirouteintel.io/api/v1/traceback/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"limit": 10}'

# Around line 125 - Python example
headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {api_key}'
}

# Around line 151 - JavaScript example
headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`
}

# Around line 173 - PHP example
$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
];

# Around line 214 - Error table
Include Authorization: Bearer header

Python

import os
import requests

# Get API key from environment variable
api_key = os.getenv('TRACEBACK_API_KEY')

headers = {
    'Content-Type': 'application/json',
    'X-API-Key': api_key
}

response = requests.post(
    'https://api-service.verirouteintel.io/api/v1/traceback/search',
    headers=headers,
    json={'limit': 10}
)

print(response.json())

JavaScript

// Using environment variable (Node.js)
const apiKey = process.env.TRACEBACK_API_KEY;

const response = await fetch('https://api-service.verirouteintel.io/api/v1/traceback/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': apiKey
  },
  body: JSON.stringify({ limit: 10 })
});

const data = await response.json();
console.log(data);

PHP

 10]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api-service.verirouteintel.io/api/v1/traceback/search');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Authentication Errors

Common Authentication Issues

HTTP Status	Error Code	Description	Solution
401	`MISSING_API_KEY`	No API key provided in request	Include X-API-Key header
401	`INVALID_API_KEY`	API key is invalid or expired	Check your API key in dashboard
403	`INSUFFICIENT_PERMISSIONS`	API key lacks required permissions	Upgrade your plan or contact support
403	`ACCOUNT_SUSPENDED`	Account has been suspended	Contact support for assistance

Next Steps

Now that you understand authentication, explore these sections:

REST Endpoints

Learn about available API endpoints and their parameters

Code Examples

See complete code examples in your preferred language

API Documentation