List beaches

GET

/beaches/

Search and list beaches. Supports offset/limit pagination (default: 100 results, max: 500).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

Beach list.

Bodyapplication/json

🟠401

🟠402

🟠429

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "count": 47,
    "results": [
        {
            "id": 1,
            "name": "Venice Beach",
            "state": "CA",
            "latitude": 33.985,
            "longitude": -118.469,
            "nearest_buoy_id": "46025",
            "nearest_tide_station": "9410660"
        }
    ]
}

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

Health check

Get beach detail