Get paginated historical readings for a buoy. Supports filtering by date range.
Historical Data: For Candhis buoys, historical data is automatically retrieved from optimized storage for dates older than 2 months, ensuring fast and reliable access to historical readings. Recent data (within 2 months) is retrieved from the live database.
Pagination: Default 20 per page, minimum 1, maximum 100 per page.
API key authentication. Pass your API key as a Bearer token in the Authorization header.
Format: Authorization: Bearer YOUR_API_KEY
Alternative: Pass as query parameter ?api_key=YOUR_API_KEY
Security: API keys are stored as BCrypt hashes (never plain text). Only the hash is stored in the database.
Start date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ)
End date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ)
Filter by single date (YYYY-MM-DD). Alternative to start_date/end_date.
Filter by unix timestamp (seconds). Returns readings within a 3-hour window.
Sort order
asc, desc 1 <= x <= 100Enable debug mode to include query plan and SQL in response (adds overhead)
Bypass Kaminari pagination and use manual pagination (for performance testing)