Authentication

All API requests require authentication using an API key.

API Keys

API keys use the format: ned_live_ followed by 32 hexadecimal characters.

Example: ned_live_a1b2c3d4e5f6789012345678901234ab

Creating an API Key

1. Navigate to Settings → Developer in your Ned dashboard
2. Click Create API Key
3. Enter a descriptive name
4. Optionally set an expiration date
5. Copy the key immediately - it's only shown once!

Using Your API Key

Include the key in the Authorization header:

curl -H "Authorization: Bearer ned_live_YOUR_KEY" \
  "https://api.meetned.com/api/v1/sales/analytics"

Rate Limits

Rate limits vary by subscription tier:

Tier	Requests per Minute
Essential	30
Growth	60
Scale	120

Rate Limit Headers

Every response includes rate limit information:

Ratelimit: limit=60, remaining=58, reset=45
Ratelimit-Policy: 60;w=60

Handling Rate Limits

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please wait before retrying.",
  "retry_after": 45
}

Wait for the retry_after seconds before making another request.

Key Management

• Maximum keys: 10 per account
• Revoking keys: Go to Settings → Developer and click Revoke
• Revoked keys: Immediately stop working and return 401

Security Best Practices

1. Never commit API keys to version control
2. Use environment variables to store keys
3. Rotate keys regularly for production use
4. Revoke unused keys to minimize risk
5. Use separate keys for development and production