Introduction

The NOAA Tides API provides you with the high and low tide prediction times and heights for each NOAA tide station in the United States. Responses are in JSON format.

Pricing Plans and Usage

Basic - This plan is suited for developers and basic website/app needs with limited usage.
Pro - More requests for a commercial app or website.
Ultra - Enjoy unlimited requests. Best for enterprise usage.

Endpoints (all endpoints are GET methods)

/stations -> returns a list of all NOAA tide stations and summary information for each one

Sample Response

{
    "stations": [
        {
            "id": "1611400",
            "name": "Nawiliwili",
            "state": "HI",
            "long_name": "1611400 Nawiliwili HI"
        },
        {
            "id": "1612340",
            "name": "Honolulu",
            "state": "HI",
            "long_name": "1612340 Honolulu HI"
        },
        {
            "id": "1617760",
            "name": "Hilo, Hilo Bay, Kuhio Bay",
            "state": "HI",
            "long_name": "1617760 Hilo, Hilo Bay, Kuhio Bay HI"
        },
        {
            "id": "1619910",
            "name": "Sand Island, Midway Islands",
            "state": "United States of America",
            "long_name": "1619910 Sand Island, Midway Islands United States of America"
        },
        {
            "id": "1630000",
            "name": "Apra Harbor, Guam",
            "state": "United States of America",
            "long_name": "1630000 Apra Harbor, Guam United States of America"
        },
        {
            "id": "1631428",
            "name": "Pago Bay, Guam",
            "state": "United States of America",
            "long_name": "1631428 Pago Bay, Guam United States of America"
        },
        {...
        }
    ]
}

/stations/{id} -> returns detailed information for the given station ID

Sample Response

{
    "station_id": "9410840",
    "name": "Santa Monica",
    "state": "CA",
    "latitude": "34.0083",
    "longitude": "-118.5",
    "time_zone": "PST",
    "time_zone_offset": "-8",
    "noaa_chart": "18744",
    "established": "01 Oct 1932 "
}

/stations/{id}/tides -> returns tide information for the given station ID on the current date

Sample Response

{
    "station_id": "8570283",
    "tides": [
        {
            "date": "16 Jun 2022",
            "time": "04:03 AM",
            "type": "Low",
            "height": "0.136"
        },
        {
            "date": "16 Jun 2022",
            "time": "10:04 AM",
            "type": "High",
            "height": "2.235"
        },
        {
            "date": "16 Jun 2022",
            "time": "03:49 PM",
            "type": "Low",
            "height": "-0.137"
        },
        {
            "date": "16 Jun 2022",
            "time": "10:49 PM",
            "type": "High",
            "height": "3.057"
        }
    ]
}

Parameters
The following query string parameters can be used with the /tides endpoint:
date -> provide a specific date for tide information (date in YYYYMMDD format)
from/to -> provide a date range for tide information (dates in YYYYMMDD format)

Examples:
/stations/{id}/tides?date=20220530 -> Get tide information for May 30, 2022
/stations/{id}/tides?from=20220101&to=20220131 -> Get tide information from Jan 1, 2022 to Jan 31, 2022

Errors

400 - Invalid Request (you have specified an invalid resource or not supplied appropriate path parameters)
401 - Unauthorized (you are not authorized to use the specified endpoint)
404 - Value Not Found (the provided station ID could not be found)

Please Note

All response data is provided in string format for easy and consistent usage.
Field order in response is not guaranteed or preserved.
In order to make our API data ever-evolving, new fields could be added at any time.

Thank you

We strive to provide the most up-to-date data available. If for any reason you notice data discrepancies, please contact us immediately so we can resolve them.