Skip to main content
GET
/
buoys
/
{buoy_id}
Get buoy details
curl --request GET \
  --url https://thesurfkit.com/api/v2/buoys/{buoy_id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": {
    "buoy": {
      "id": 10,
      "name": "Anglet",
      "slug": "anglet",
      "lat": 43.4832,
      "lng": -1.5586,
      "source": "Candhis",
      "source_identifier": "64002",
      "country": "France",
      "last_reading_time": "2025-11-01T10:00:00Z",
      "readings_count": 125430,
      "last_reading": {
        "uuid": "abc-123-def",
        "significient_height": 1.5,
        "maximum_height": 2,
        "period": 8.5,
        "time": "2025-11-01T10:00:00Z",
        "water_temperature": 18.5,
        "direction": 270,
        "unit": "m"
      }
    }
  },
  "meta": {
    "timestamp": "2025-11-01T10:00:00Z"
  }
}

Authorizations

Authorization
string
header
required

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.

Path Parameters

buoy_id
string
required

Buoy ID or slug (friendly ID)

Response

Successful response

status
string
Example:

"success"

data
object