> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Beach Day API

> Beach Day API provides beach search, conditions, scores, rules, amenities, tide predictions, and country coverage data.

![Beach Day API logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/beach_day_api.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=6186264b9e800c650b177f1eb02314f4)

* **Category:** lifestyle & entertainment
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `BEACH_DAY_API`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Beach Amenities
>
> **Slug:** `BEACH_DAY_API_GET_BEACH_AMENITIES`
>
> Get facilities and accessibility amenities for a beach without paying for the full beach profile. Costs 2 API credits.
>
> #### Input Parameters
>
> **beach\_id** `integer` *required*
>
> Beach ID returned by Search Beaches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Beach Details
>
> **Slug:** `BEACH_DAY_API_GET_BEACH_DETAILS`
>
> Get a full beach profile, including current score, water quality, weather, ocean conditions, rules, and amenities. Costs 5 API credits.
>
> #### Input Parameters
>
> **beach\_id** `integer` *required*
>
> Beach ID returned by Search Beaches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Beach Rules
>
> **Slug:** `BEACH_DAY_API_GET_BEACH_RULES`
>
> Get activity rules for a beach without paying for the full beach profile. Costs 2 API credits.
>
> #### Input Parameters
>
> **beach\_id** `integer` *required*
>
> Beach ID returned by Search Beaches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tide Predictions
>
> **Slug:** `BEACH_DAY_API_GET_TIDE_PREDICTIONS`
>
> Get up to seven days of stored tide-prediction groups for a beach. Each successful request costs 1 API credit.
>
> #### Input Parameters
>
> **beach\_id** `integer` *required*
>
> Beach ID returned by Search Beaches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Beach Conditions
>
> **Slug:** `BEACH_DAY_API_LIST_BEACH_CONDITIONS`
>
> Return current and recent condition snapshots for a beach, including score, water quality, weather, ocean conditions, and available tide data. Costs 3 API credits per page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum condition snapshots to return in this page (1-200).
>
> **offset** `integer`
>
> Zero-based index of the first condition snapshot to return. Omit for the first page, then pass the previous response's next\_offset (repeating the same beach\_id and limit) to get the next page.
>
> **beach\_id** `integer` *required*
>
> Beach ID returned by Search Beaches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Beaches by Score
>
> **Slug:** `BEACH_DAY_API_LIST_BEACHES_BY_SCORE`
>
> Return beaches ranked by current Beach Day Score from highest to lowest. Costs 10 API credits per page; use only when ranking is needed.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum ranked beaches to return in this page (1-200).
>
> **offset** `integer`
>
> Zero-based index of the first ranked beach to return. Omit for the first page, then pass the previous response's next\_offset (repeating the same limit) to get the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Countries
>
> **Slug:** `BEACH_DAY_API_LIST_COUNTRIES`
>
> List countries covered by Beach Day API with beach counts, ordered from highest to lowest count. Costs 1 API credit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Beaches
>
> **Slug:** `BEACH_DAY_API_SEARCH_BEACHES`
>
> Find beaches by name, country, or state/province code and return IDs for detail, conditions, rules, amenities, and tide lookups. Costs 1 API credit per page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum beaches to return in this page (1-500).
>
> **state** `string`
>
> State or province code, such as CA, AU-NSW, ES-AN, or BR-RJ.
>
> **offset** `integer`
>
> Zero-based index of the first beach to return. Omit for the first page, then pass the previous response's next\_offset (repeating the same search, country, state, and limit) to get the next page.
>
> **search** `string`
>
> Case-insensitive beach-name search term, such as Malibu.
>
> **country** `string`
>
> Case-insensitive country name, such as United States or New Zealand.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
