List beach conditions

GET

/beaches/{id}/conditions/

Returns condition snapshots for a beach. Supports offset/limit pagination (default: 30 results, max: 200).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Condition history.

Bodyapplication/json

🟠401

🟠402

🟠404

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://beachdayapi.com/v1/beaches//conditions/?offset=&limit=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "beach_id": 1,
    "count": 45,
    "results": [
        {
            "id": 101,
            "beach_id": 1,
            "date": "2026-06-24",
            "water_quality": {
                "grade": "A",
                "advisory": false,
                "updated": "2026-06-24T08:00:00Z"
            },
            "weather": {
                "temp_f": 74,
                "condition": "clear",
                "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"
            },
            "tides": [
                {
                    "time": "2026-06-24T06:14:00-07:00",
                    "type": "high",
                    "height_ft": 5.1
                },
                {
                    "time": "2026-06-24T12:41:00-07:00",
                    "type": "low",
                    "height_ft": 0.8
                }
            ],
            "beach_day_score": 82
        }
    ]
}

Modified at 2026-07-14 21:45:45

Get beach amenities

Get tide predictions