---
title: "Get scored beaches"
method: GET
path: "/beaches/scored/"
tags: ["Beaches"]
---

# Get scored beaches

`GET /beaches/scored/`

## Request

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

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

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Beach ranking.

- object
  - `results` BeachDetail[], required
    - `id` integer, required
    - `name` string, required
    - `state` string, required: Two-letter US state code or compound AU code such as AU-NSW.
    - `country` string: Country name (e.g., 'United States', 'Cambodia', 'Thailand', 'French Polynesia', 'New Caledonia', 'Fiji', 'Samoa', 'Tonga', 'New Zealand').
    - `county` string
    - `city` string
    - `latitude` number, float, nullable, required
    - `longitude` number, float, nullable, required
    - `description` string, required
    - `nearest_buoy_id` string, required
    - `nearest_tide_station` string, required
    - `beach_day_score` number, nullable, required
    - `water_quality` JsonBlob, required
    - `weather` JsonBlob, required
    - `ocean_conditions` JsonBlob, required
    - `rules` BeachRule[], required
      - `category` 'dogs' | 'alcohol' | 'fires' | 'smoking' | 'camping' | 'drones' | 'parking' | 'other', required
      - `status` 'allowed' | 'prohibited' | 'restricted' | 'seasonal', required
      - `notes` string, required
    - `amenities` BeachAmenity[], required
      - `category` 'restrooms' | 'showers' | 'lifeguard' | 'parking_lot' | 'food' | 'picnic' | 'playground' | 'accessibility' | 'rentals', required
      - `available` boolean, required
      - `hours` string, required
      - `notes` string, required
    - `nudism` string
    - `surf_spot` boolean
    - `supervised` string
    - `lifeguard` string
  - `count` integer, required

## Other responses

- `401`: Invalid or missing API key.
- `402`: Not enough credits.
- `429`: Too many requests.

---

[API](https://skmtc.dev/beachdayapi/apis/beach-day-api.md) · [All operations](https://skmtc.dev/beachdayapi/apis/beach-day-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beachdayapi/apis/beach-day-api/revisions/6c8fdd6792f5?raw)