# Guide

The Tidal Forecast API provides tide predictions for coastal locations, including high/low tide times and levels.

For full request and response field details, see [Tidal Forecast Parameters](/developers/tidal-forecast/parameters).

:::note{title="Base URLs"}

- **Production:** api.accuweather.com
- **Development:** apidev.accuweather.com

Examples below use the production host. Swap in apidev.accuweather.com for development.

:::

| Endpoint | Description |
|---|---|
| [Tidal forecast by location key](#tidal-forecast-by-locationkey) | Daily tidal forecasts for stations near a location |
| [Tidal station metadata](#tidal-station-metadata) | Metadata for a specific tidal station |

## Tidal forecast by location key

Returns an array of daily tidal forecasts for every tidal station that falls within the area defined by the given location key. Available for 1 Day, 5 Days, 10 Days, 15 Days, 25 Days, or 45 Days.

```
https://{baseUrl}/tidal/{version}/forecasts/{dayCount}/{locationKey}{.format}?apikey={your key}{&language={language code}}{&allowError=true or false}
```

### Example

1 day of tidal forecasts by location key

```
https://api.accuweather.com/tidal/v1/forecasts/1day/2231170?apikey={your key}
```

**Response:**

```json
[
   {
      "Date": "2016-09-29T00:00:00-05:00",
      "EpochTime": 1475107200,
      "Forecasts": [
         {
            "Station": {
               "Id": 1731,
               "Name": "Gulf Shores, Icww",
               "Primary": true
            },
            "Tides": [
               {
                  "DateTime": "2016-09-29T01:25:00-05:00",
                  "EpochTime": 1475112300,
                  "Type": "High",
                  "Height": {
                     "Metric": {
                        "Value": 27,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 0.9,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T04:44:00-05:00",
                  "EpochTime": 1475124240,
                  "Type": "Low",
                  "Height": {
                     "Metric": {
                        "Value": 27,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 0.9,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T12:16:00-05:00",
                  "EpochTime": 1475151360,
                  "Type": "High",
                  "Height": {
                     "Metric": {
                        "Value": 34,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 1.1,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T18:47:00-05:00",
                  "EpochTime": 1475174820,
                  "Type": "Low",
                  "Height": {
                     "Metric": {
                        "Value": 27,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 0.9,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               }
            ]
         },
         {
            "Station": {
               "Id": 1732,
               "Name": "Bon Secour, Bon Secour River",
               "Primary": false
            },
            "Tides": [
               {
                  "DateTime": "2016-09-29T01:28:00-05:00",
                  "EpochTime": 1475112480,
                  "Type": "High",
                  "Height": {
                     "Metric": {
                        "Value": 40,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 1.3,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T05:39:00-05:00",
                  "EpochTime": 1475127540,
                  "Type": "Low",
                  "Height": {
                     "Metric": {
                        "Value": 34,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 1.1,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T12:46:00-05:00",
                  "EpochTime": 1475153160,
                  "Type": "High",
                  "Height": {
                     "Metric": {
                        "Value": 43,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 1.4,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               },
               {
                  "DateTime": "2016-09-29T18:52:00-05:00",
                  "EpochTime": 1475175120,
                  "Type": "Low",
                  "Height": {
                     "Metric": {
                        "Value": 34,
                        "Unit": "cm",
                        "UnitType": 4
                     },
                     "Imperial": {
                        "Value": 1.1,
                        "Unit": "ft",
                        "UnitType": 0
                     }
                  }
               }
            ]
         },
         ...
      ],
      "MobileLink": null,
      "Link": "https://www.accuweather.com/en/us/gulf-shores-al/36542/tides/2231170?day=1&lang=en-us"
   }
]
```

## Tidal station metadata

Returns information about individual tidal stations, including time zone, country, administrative area, and geoposition.

```
https://{baseUrl}/tidal/{version}/stations/{stationId}{.format}?apikey={your key}{&language={language code}}{&allowError=true or false}
```

### Example

```
https://api.accuweather.com/tidal/v1/stations/635?apikey={your key}&allowError=false
```

**Response:**

```json
[
   {
      "Station": {
         "Id": 635,
         "Name": "Market Street Bridge",
         "Primary": false
      },
      "GeoPosition": {
         "Latitude": 39.955,
         "Longitude": -75.18
      },
      "TimeZone": {
         "Code": "EDT",
         "Name": "America/New_York",
         "GmtOffset": -4
      },
      "Country": {
         "ID": "US",
         "Name": "United States"
      },
      "AdministrativeArea": {
         "ID": "PA",
         "Name": "Pennsylvania",
         "Level": 1,
         "CountryID": "US"
      }
   }
]
```