---
title: "Get beach detail"
method: GET
path: "/beaches/{id}/"
tags: ["Beaches"]
---

# Get beach detail

`GET /beaches/{id}/`

## Request

- Base URL: `https://beachdayapi.com/v1`
- URL: `https://beachdayapi.com/v1/beaches/{id}/`
- Auth: HTTP bearer

Returns a beach record plus the latest stored condition data, rules, and amenities.

## Path parameters

- `id` integer, required

## Response `200`

Beach detail.

- BeachDetail
  - `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

## Other responses

- `401`: Invalid or missing API key.
- `402`: Not enough credits.
- `404`: Beach not found.
- `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)