Authentication

The InBe API uses API key authentication for all requests.

Getting Your API Key

1. Sign up for an InBe account
2. Navigate to your dashboard
3. Go to the API Keys section
4. Create a new API key

Using Your API Key

Include your API key in the Authorization header of all requests:

curl -X GET "https://api.inbe.us/v1/locations/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Security Best Practice

• Keep your API key secure - Never expose it in client-side code
• Use environment variables - Store your API key in environment variables
• Rotate regularly - Generate new API keys periodically
• Monitor usage - Check your API usage in the dashboard

Rate Limiting

Your API key determines your rate limits:

• Free tier: 1,000 requests per month
• Pro tier: 10,000 requests per month
• Enterprise: Custom limits

Error Responses

If authentication fails, you'll receive a 401 error:

{
  "error": "Unauthorized",
  "message": "Invalid API key",
  "code": 401
}

SDK Examples

JavaScript/Node.js

const response = await fetch("https://api.inbe.us/v1/locations/search", {
  headers: {
    Authorization: `Bearer ${process.env.INBE_API_KEY}`,
    "Content-Type": "application/json",
  },
});

Python

import requests

headers = {
    'Authorization': f'Bearer {os.environ["INBE_API_KEY"]}',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.inbe.us/v1/locations/search', headers=headers)