Get a paginated list of buoys with optional filtering by geographic bounds, source, or active status.
Returns buoys in a standardized V2 format with pagination metadata.
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.
Geographic bounding box as JSON string {"north":44,"south":43,"east":-1,"west":-2}
Coordinates and radius in format lat,lng (e.g., "43.5,-1.5"). Use with radius parameter.
Search radius in kilometers (used with near parameter, default: 100)
Filter by source (e.g., "Candhis", "Meteo France", "Sofar Ocean")
Filter by ISO 3166-1 alpha-2 country code (e.g., "FR", "ES", "PT"). When set, up to 500 buoys are returned per page.
^[A-Z]{2}$Only return buoys with recent readings (default: true)
x <= 500