---
title: "List beach conditions"
method: GET
path: "/beaches/{id}/conditions/"
tags: ["Conditions"]
---

# List beach conditions

`GET /beaches/{id}/conditions/`

## Request

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

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

## Path parameters

- `id` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Condition history.

- BeachConditionsResponse
  - `beach_id` integer, required
  - `count` integer, required
  - `results` BeachConditionsItem[], required
    - `id` integer, required
    - `beach_id` integer, required
    - `date` string, date, required
    - `water_quality` JsonBlob, required
    - `weather` JsonBlob, required
    - `ocean_conditions` JsonBlob, required
    - `tides` JsonBlob[], nullable, required
    - `beach_day_score` number, nullable, required

## 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)