Beaches

List beaches

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

get/beaches/

Request

Base URL: https://beachdayapi.com/v1
URL: https://beachdayapi.com/v1/beaches/
Auth: HTTP bearer

Query parameters

statestring

Filter by state code, for example CA, FL, HI, or AU-NSW.

countrystring

Filter by country name (e.g., 'Croatia', 'Greece', 'Thailand', 'French Polynesia', 'New Caledonia', 'Fiji', 'Samoa', 'Tonga', 'New Zealand'). Case-insensitive.

searchstring

Search beaches by name (case-insensitive, e.g. 'Malibu').

offsetinteger

Number of results to skip (default: 0).

limitinteger

Max results per page (default: 100, max: 500).

Response

Beach list.

countinteger required

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.