Skip to main content

Authentication

All API requests require authentication using an API key.

API Keys

API keys are used to authenticate your requests. You can generate and manage API keys from your dashboard. Each key can be given a name and description for easy identification.

Key Format

API keys use the prefix edns_live_ followed by a unique identifier. All API calls count toward your usage.

Using Your API Key

Include your API key as a Bearer token in the Authorization header of every request:

curl "https://api.edgedns.dev/v1/dns/lookup?domain=example.com" \
  -H "Authorization: Bearer edns_live_YOUR_KEY"

Security Best Practices

  • Never expose your API key in client-side code
  • Use environment variables to store your API key
  • Rotate your API keys periodically
  • Configure IP allowlists in the dashboard to restrict key usage to trusted IPs