Authentication
Authenticate with the LocalSDK API using Bearer tokens.
Base URL
All API requests are made to:
https://api.localsdk.comAuthentication
The LocalSDK API uses Bearer token authentication. Include your API key in the Authorization header of every request.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.localsdk.com/api/v1/locations/currentGetting your API key
- Sign in to the LocalSDK Dashboard
- Navigate to API Keys
- Create or copy your key
Unauthenticated endpoints
The following endpoints do not require authentication:
| Endpoint | Description |
|---|---|
GET /health | Check if the API is running |
GET /docs | Returns the OpenAPI specification |
Error responses
| Code | Description |
|---|---|
401 | Missing or invalid API key |
403 | API key does not have permission for this resource |
429 | Rate limit exceeded — varies by API key tier |
Rate Limits
Rate limits vary by API key tier. If you exceed your limit, the API returns a 429 status code. Contact support to increase your limits.
Data Retention
Location data is retained for 1 year. Recent data (last 7 days) is served from DynamoDB for fast access. Older data is queried from Athena/S3.