# The Buoy API

## Docs

- [Find nearest buoy to coordinates](https://docs.labouee.app/api-reference/buoys/find-nearest-buoy-to-coordinates.md): Find the closest active buoy(s) to a given latitude and longitude within a maximum distance.
- [Get a specific buoy reading](https://docs.labouee.app/api-reference/buoys/get-a-specific-buoy-reading.md): Get detailed information about a specific reading from a buoy.
- [Get buoy details](https://docs.labouee.app/api-reference/buoys/get-buoy-details.md): Get detailed information about a specific buoy.
- [Get chart data for a buoy](https://docs.labouee.app/api-reference/buoys/get-chart-data-for-a-buoy.md): Returns comprehensive chart data including readings, forecasts, and tide levels.
- [Get historical readings for a buoy](https://docs.labouee.app/api-reference/buoys/get-historical-readings-for-a-buoy.md): Get paginated historical readings for a buoy. Supports filtering by date range.
- [Get last readings for multiple buoys](https://docs.labouee.app/api-reference/buoys/get-last-readings-for-multiple-buoys.md): Bulk fetch the latest reading for a list of buoys by ID.
- [Get seasonal buoy reading series](https://docs.labouee.app/api-reference/buoys/get-seasonal-buoy-reading-series.md): Returns grouped year-over-year seasonal time series for a single buoy without pagination.
- [List all buoys](https://docs.labouee.app/api-reference/buoys/list-all-buoys.md): Get a paginated list of buoys with optional filtering by geographic bounds, source, or active status.
- [Search buoys](https://docs.labouee.app/api-reference/buoys/search-buoys.md): Search for buoys by name, slug, or source identifier.
- [Search for reading closest to a specific time](https://docs.labouee.app/api-reference/buoys/search-for-reading-closest-to-a-specific-time.md): Find the reading closest to a target datetime within a tolerance window.
- [Get all-in-one conditions (V2)](https://docs.labouee.app/api-reference/conditions/get-all-in-one-conditions-v2.md): Returns combined forecast, reading, and tide data for a location in a standardized V2 format.
- [API Reference](https://docs.labouee.app/api-reference/introduction.md): Buoy endpoints only — list, search, readings, and charts. All operations are GET (read-only).
- [Authentication](https://docs.labouee.app/authentication.md): All v2 API requests require an API key passed as a Bearer token.
- [Fetching Buoys by Country](https://docs.labouee.app/guides/country-buoys.md): Get all active buoys for a country — with their latest readings — in a single API call.
- [Bulk Last Readings](https://docs.labouee.app/guides/last-readings.md): Efficiently fetch the latest reading for a known list of buoys.
- [Rate Limits](https://docs.labouee.app/guides/rate-limits.md): Understand your request quota and handle 429 responses gracefully.
- [The Buoy API](https://docs.labouee.app/index.md): Real-time ocean buoy data for developers. Wave heights, periods, water temperatures, and more — served fresh from active buoy networks.
- [Quickstart](https://docs.labouee.app/quickstart.md): Make your first Buoy API call in under 5 minutes.

## OpenAPI Specs

- [openapi](https://docs.labouee.app/api-reference/openapi.json)

## Optional

- [Support](mailto:api-support@thesurfkit.com)