1. Beaches
Beach Day API
  • Beach Day API
    • Health
      • Health check
    • Beaches
      • List beaches
        GET
      • Get beach detail
        GET
      • Get scored beaches
        GET
      • Get beach rules
        GET
      • Get beach amenities
        GET
    • Conditions
      • List beach conditions
    • Tides
      • Get tide predictions
    • Countries
      • List available countries
    • Schemas
      • HealthResponse
      • ErrorResponse
      • BeachListItem
      • BeachListResponse
      • JsonBlob
      • BeachRule
      • BeachAmenity
      • BeachDetail
      • BeachConditionsItem
      • BeachConditionsResponse
      • BeachRulesResponse
      • BeachAmenitiesResponse
      • TidePrediction
      • TideResponse
      • CountryListResponse
      • CountryItem
  1. Beaches

Get scored beaches

GET
/beaches/scored/
Returns beaches ranked by beach day score. Supports offset/limit pagination (default: 50 results, max: 200).

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200
application/json
Beach ranking.
Bodyapplication/json

🟠401
🟠402
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://beachdayapi.com/v1/beaches/scored/?offset=&limit=' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "results": [
        {
            "id": 1,
            "name": "Venice Beach",
            "state": "CA",
            "county": "Los Angeles",
            "city": "Los Angeles",
            "latitude": 33.985,
            "longitude": -118.4695,
            "description": "Popular Los Angeles beach with boardwalk access.",
            "nearest_buoy_id": "46025",
            "nearest_tide_station": "9410660",
            "beach_day_score": 82,
            "water_quality": {
                "grade": "A",
                "advisory": false,
                "source": "LA County Public Health",
                "updated": "2026-06-24T08:00:00Z"
            },
            "weather": {
                "temp_f": 74,
                "condition": "clear",
                "uv_index": 8,
                "wind_speed_mph": 6,
                "humidity_pct": 68,
                "precipitation_in": 0
            },
            "ocean_conditions": {
                "water_temp_f": 66,
                "wave_height_ft": 2.4,
                "rip_current_risk": "moderate"
            },
            "rules": [
                {
                    "category": "dogs",
                    "status": "restricted",
                    "notes": "Allowed on leash before 10am."
                },
                {
                    "category": "alcohol",
                    "status": "prohibited",
                    "notes": "No alcohol on the beach."
                }
            ],
            "amenities": [
                {
                    "category": "lifeguard",
                    "available": true,
                    "hours": "9am-6pm",
                    "notes": "Seasonal staffed towers."
                },
                {
                    "category": "restrooms",
                    "available": true,
                    "hours": "",
                    "notes": "Public restrooms near the boardwalk."
                }
            ]
        },
        {
            "id": 2,
            "name": "Santa Monica State Beach",
            "state": "CA",
            "county": "Los Angeles",
            "city": "Santa Monica",
            "latitude": 34.0094,
            "longitude": -118.4973,
            "description": "Wide sandy beach with easy access and family amenities.",
            "nearest_buoy_id": "46025",
            "nearest_tide_station": "9410840",
            "beach_day_score": 79,
            "water_quality": {
                "grade": "A-",
                "advisory": false,
                "source": "LA County Public Health",
                "updated": "2026-06-24T08:00:00Z"
            },
            "weather": {
                "temp_f": 72,
                "condition": "partly_cloudy",
                "uv_index": 7,
                "wind_speed_mph": 7,
                "humidity_pct": 68,
                "precipitation_in": 0
            },
            "ocean_conditions": {
                "water_temp_f": 65,
                "wave_height_ft": 2,
                "rip_current_risk": "low"
            },
            "rules": [
                {
                    "category": "dogs",
                    "status": "prohibited",
                    "notes": "No dogs on the sand."
                }
            ],
            "amenities": [
                {
                    "category": "parking_lot",
                    "available": true,
                    "hours": "",
                    "notes": "Paid public lots nearby."
                }
            ]
        }
    ]
}
Modified at 2026-07-14 21:45:45
Previous
Get beach detail
Next
Get beach rules
Built with