API Docs


Authentication

The Marinas.com API supports both authenticated and unauthenticated requests. Requests are authenticated requests with an API Key, which is put into the access_token query parameter of any request. Or as an Authorization header Authorization: Bearer access_token Get yours at the developers homepage.

Request
curl -XGET https://api.marinas.com/v1/points/jncq

The Marinas.com API returns preformed links on point of interest data to help assist you in database traversal and Attribution requirements. The web_url, api_url, and icon_url properties will always return a working link for you to embed in your application.

Response
{
  "id": "jncq",
  "resource": "point",
  "name": "Baltimore Yacht Club",
  "kind": "marina",
  "rating": "4.0",
  "review_count": 2,
  "location": {
    "lat": 39.28783449044417,
    "lon": -76.39857580839772,
    "what3words": "figs.ongoing.hesitating"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/marina/jncq_Baltimore_Yacht_Club_Essex_MD_United_States",
  "api_url": "https://api.marinas.com/v1/marinas/jncq",
  "icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
  "fuel": {
    "has_diesel": true,
    "has_propane": false,
    "has_gas": true,
    "propane_price": null,
    "diesel_price": null,
    "gas_regular_price": null,
    "gas_super_price": null,
    "gas_premium_price": null
  },
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
    "regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
  }
}

Searches through all points of interest, returning a Geolist of Points objects.

Points can be any kind from marina, harbor, anchorage, inlet, bridge, lock, lighthouse, ferry, landmark, ramp.

Points are essentially polymorphic wrappers around the individual point of interest data types. For example, a Marina object has more properties than a Point. To access those, you can either use the Marina search API or retrieve the associated object from the api_url property.

Arguments
kinds | optional
set of marina, anchorage, harbor, inlet, bridge, lock, lighthouse, ferry, landmark, ramp.
query | optional
class String
location | optional
lat | optional
number greater than or equal to -90 and less than or equal to 90
lon | optional
number greater than or equal to -180 and less than or equal to 180
what3words | optional
what three words 
radius | optional
number greater than 0
bounds | optional
ne
lat
number greater than or equal to -90 and less than or equal to 90
lon
number greater than or equal to -180 and less than or equal to 180
sw
lat
number greater than or equal to -90 and less than or equal to 90
lon
number greater than or equal to -180 and less than or equal to 180
Request
curl -XGET -G https://api.marinas.com/v1/points/search \
-d 'location[lat]=39.28783449044417' \
-d 'location[lon]=-76.39857580839772'
Response
{
  "resource": "geolist",
  "data": [
    {
      "id": "jncq",
      "resource": "point",
      "name": "Baltimore Yacht Club",
      "kind": "marina",
      "rating": "4.0",
      "review_count": 2,
      "location": {
        "lat": 39.28783449044417,
        "lon": -76.39857580839772,
        "what3words": "figs.ongoing.hesitating"
      },
      "images": {
        "resource": "list",
        "data": [

        ],
        "total_count": 0
      },
      "web_url": "https://marinas.com/view/marina/jncq_Baltimore_Yacht_Club_Essex_MD_United_States",
      "api_url": "https://api.marinas.com/v1/marinas/jncq",
      "icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
      "fuel": {
        "has_diesel": true,
        "has_propane": false,
        "has_gas": true,
        "propane_price": null,
        "diesel_price": null,
        "gas_regular_price": null,
        "gas_super_price": null,
        "gas_premium_price": null
      },
      "icon_urls": {
        "light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
        "regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
        "dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
      }
    }
  ],
  "bounds": {
    "ne": {
      "lat": 39.28783449044417,
      "lon": -76.39857580839772
    },
    "sw": {
      "lat": 39.28783449044417,
      "lon": -76.39857580839772
    }
  },
  "total_count": 209
}
Point Retrieve

Returns the requested point

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/points/jncq
Response
{
  "id": "jncq",
  "resource": "point",
  "name": "Baltimore Yacht Club",
  "kind": "marina",
  "rating": "4.0",
  "review_count": 2,
  "location": {
    "lat": 39.28783449044417,
    "lon": -76.39857580839772,
    "what3words": "figs.ongoing.hesitating"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/marina/jncq_Baltimore_Yacht_Club_Essex_MD_United_States",
  "api_url": "https://api.marinas.com/v1/marinas/jncq",
  "icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
  "fuel": {
    "has_diesel": true,
    "has_propane": false,
    "has_gas": true,
    "propane_price": null,
    "diesel_price": null,
    "gas_regular_price": null,
    "gas_super_price": null,
    "gas_premium_price": null
  },
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
    "regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
  }
}

Searches through all Marina objects, returning a Geolist of Marinas

Arguments
query | optional
class String
fuel | optional
has_diesel | optional
inclusion in true, false.
has_gas | optional
inclusion in true, false.
has_propane | optional
inclusion in true, false.
location | optional
lat | optional
number greater than or equal to -90 and less than or equal to 90
lon | optional
number greater than or equal to -180 and less than or equal to 180
what3words | optional
what three words 
radius | optional
number greater than 0
bounds | optional
ne
lat
number greater than or equal to -90 and less than or equal to 90
lon
number greater than or equal to -180 and less than or equal to 180
sw
lat
number greater than or equal to -90 and less than or equal to 90
lon
number greater than or equal to -180 and less than or equal to 180
Request
curl -XGET -G https://api.marinas.com/v1/marinas/search \
-d 'location[lat]=39.283166666638884' \
-d 'location[lon]=-76.3955'
Response
{
  "resource": "geolist",
  "data": [
    {
      "id": "eycq",
      "resource": "marina",
      "name": "All Star Marine",
      "rating": null,
      "review_count": 0,
      "location": {
        "lat": 39.283166666638884,
        "lon": -76.3955,
        "what3words": "lawn.dunked.flies"
      },
      "images": {
        "resource": "list",
        "data": [

        ],
        "total_count": 0
      },
      "web_url": "https://marinas.com/view/marina/eycq_All_Star_Marine_Middle_River_MD_United_States",
      "api_url": "https://api.marinas.com/v1/marinas/eycq",
      "icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
      "icon_urls": {
        "light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
        "regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
        "dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
      },
      "fuel": {
        "has_diesel": false,
        "has_propane": false,
        "has_gas": false,
        "propane_price": null,
        "diesel_price": null,
        "gas_regular_price": null,
        "gas_super_price": null,
        "gas_premium_price": null
      }
    }
  ],
  "bounds": {
    "ne": {
      "lat": 39.283166666638884,
      "lon": -76.3955
    },
    "sw": {
      "lat": 39.283166666638884,
      "lon": -76.3955
    }
  },
  "total_count": 601
}
Marina Retrieve

Returns the requested marina

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/marinas/eycq
Response
{
  "id": "eycq",
  "resource": "marina",
  "name": "All Star Marine",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 39.283166666638884,
    "lon": -76.3955,
    "what3words": "lawn.dunked.flies"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/marina/eycq_All_Star_Marine_Middle_River_MD_United_States",
  "api_url": "https://api.marinas.com/v1/marinas/eycq",
  "icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
    "regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
  },
  "fuel": {
    "has_diesel": false,
    "has_propane": false,
    "has_gas": false,
    "propane_price": null,
    "diesel_price": null,
    "gas_regular_price": null,
    "gas_super_price": null,
    "gas_premium_price": null
  }
}
Harbor Retrieve

Returns the requested harbor

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/harbors/rltp
Response
{
  "id": "rltp",
  "resource": "harbor",
  "name": "Belfast Harbor",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 44.4333,
    "lon": -69.0121994,
    "what3words": "tradition.available.considering"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/harbor/rltp_Belfast_Harbor_Belfast_ME_United_States",
  "api_url": "https://api.marinas.com/v1/harbors/rltp",
  "icon_url": "https://marinas.com/assets/map/marker_harbor-b6a4ad67eebea11fa25cccfcb58b1515b588c226eb29350fceeb52da0144b75d.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_harbor-c8ba8a95ffca2767350ee39f59707f82a3b913f6ac502a01efab799fe68ecc95.svg",
    "regular": "https://marinas.com/assets/map/marker_harbor-b6a4ad67eebea11fa25cccfcb58b1515b588c226eb29350fceeb52da0144b75d.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_harbor-4bf72282329ba3f7f436d240ec6278ecd91f9dfe525b4acbdbe3005211a49c20.svg"
  }
}
Anchorage Retrieve

Returns the requested anchorage

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/anchorages/defq
Response
{
  "id": "defq",
  "resource": "anchorage",
  "name": "Damariscove Island",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 43.7569008,
    "lon": -69.6141968,
    "what3words": "calms.vowels.foreign"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/anchorage/defq_Damariscove_Island_Anchorage_Damariscotta_ME_United_States",
  "api_url": "https://api.marinas.com/v1/anchorages/defq",
  "icon_url": "https://marinas.com/assets/map/marker_anchorage-2f24ab8edcca606182cf75e5c4941fbcb058cd442052ac1283445b75333a0dbc.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_anchorage-38e61b655945d59090fd4cf6a508a6a8e7463b29bcdfda53e870048289f28a89.svg",
    "regular": "https://marinas.com/assets/map/marker_anchorage-2f24ab8edcca606182cf75e5c4941fbcb058cd442052ac1283445b75333a0dbc.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_anchorage-ef89d62febdb605982bf5464c2a9235eaa48ca22bf0ce960cecad98719e10c8a.svg"
  }
}
Inlet Retrieve

Returns the requested inlet

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/inlets/7gim
Response
{
  "id": "7gim",
  "resource": "inlet",
  "name": "Beach Creek North Inlet",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 39.0250015,
    "lon": -74.7966995,
    "what3words": "boggles.motivations.notable"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/inlet/7gim_Beach_Creek_North_Inlet_Wildwood_NJ_United_States",
  "api_url": "https://api.marinas.com/v1/inlets/7gim",
  "icon_url": "https://marinas.com/assets/map/marker_inlet-d52f22ecf736a694c6d25afd910be07557cc743c23d6ff101f08c7d7819af587.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_inlet-0f2efbe7e8e4487d4f0586a68170fbcb4fc234a393c33793a415efb96004a5e0.svg",
    "regular": "https://marinas.com/assets/map/marker_inlet-d52f22ecf736a694c6d25afd910be07557cc743c23d6ff101f08c7d7819af587.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_inlet-6c9bbeb093269f605158c0725b0ea8e82a5df3de3d1b382c25ccd6a92e893d24.svg"
  }
}
Bridge Retrieve

Returns the requested bridge

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/bridges/rgux
Response
{
  "id": "rgux",
  "resource": "bridge",
  "name": "Maryland and Delaware Swing Bridge",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 38.7738991,
    "lon": -75.1333008,
    "what3words": "patio.breath.universally"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/bridge/rgux_Maryland_and_Delaware_Swing_Bridge_DE_United_States",
  "api_url": "https://api.marinas.com/v1/bridges/rgux",
  "icon_url": "https://marinas.com/assets/map/marker_bridge-1a891cdf787180475bf780707eb754ede507781f5d123f3d51412deda2726631.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_bridge-f85a984cc9b0b1a35a6dc0359c12c9e3b7f4ec8f7102fd0b7d9e3f87f98f2706.svg",
    "regular": "https://marinas.com/assets/map/marker_bridge-1a891cdf787180475bf780707eb754ede507781f5d123f3d51412deda2726631.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_bridge-a74ad91c41d9ed84bfe6f84d4f970356230c4cc818972f9c9f3ae186c6014d6b.svg"
  }
}
Lock Retrieve

Returns the requested lock

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/locks/y3hn
Response
{
  "id": "y3hn",
  "resource": "lock",
  "name": "Oliver Lock",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 33.2094002,
    "lon": -87.5943985,
    "what3words": "secondary.luring.reality"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/lock/y3hn_Oliver_Lock_AL_United_States",
  "api_url": "https://api.marinas.com/v1/locks/y3hn",
  "icon_url": "https://marinas.com/assets/map/marker_lock-031ad3063a02c6ae9a9e83a4b831b71e514336e5fddc42f57dd0b1b76ad4bc4f.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_lock-033a1936f243e2446f49139b3bd50a18fce252b184295a56c5382aa998ce543d.svg",
    "regular": "https://marinas.com/assets/map/marker_lock-031ad3063a02c6ae9a9e83a4b831b71e514336e5fddc42f57dd0b1b76ad4bc4f.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_lock-dc7a9ac7f2ae3766b18356c24761515921ba2d2459c40ba5e2699e609efa3986.svg"
  }
}
Lighthouse Retrieve

Returns the requested lighthouse

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/lighthouses/q6ad
Response
{
  "id": "q6ad",
  "resource": "lighthouse",
  "name": "Ostend Lighthouse - Lange Nelle",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 51.2358017,
    "lon": 2.93028,
    "what3words": "chemistry.geology.fats"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/lighthouse/q6ad_Ostend_Lighthouse_-_Lange_Nelle_Belgium",
  "api_url": "https://api.marinas.com/v1/lighthouses/q6ad",
  "icon_url": "https://marinas.com/assets/map/marker_lighthouse-4c26738be58762d672a6b14b92c79485e7fb4fd5f914f91b92c46a9dcae1d0ba.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_lighthouse-6cc43fae0cf6bfe9a6b60ce7c9bdb9fbca9a9191e5c513da38c6fe5b78ef9ada.svg",
    "regular": "https://marinas.com/assets/map/marker_lighthouse-4c26738be58762d672a6b14b92c79485e7fb4fd5f914f91b92c46a9dcae1d0ba.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_lighthouse-8275a4410d887c23e4a9b13a09b7bf2d447114ec2c79efb4c1f195caaa886c18.svg"
  }
}
Ferry Retrieve

Returns the requested ferry

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/ferrys/r1bl
Response
{
  "id": "r1bl",
  "resource": "ferry",
  "name": "Ebeltoft Faergenhavn",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 56.1502991,
    "lon": 10.6710997,
    "what3words": "rift.refinement.bonded"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/ferry/r1bl_Ebeltoft_Faergenhavn_Ferry_Aarhus_Denmark",
  "api_url": "https://api.marinas.com/v1/ferrys/r1bl",
  "icon_url": "https://marinas.com/assets/map/marker_ferry-20bb3acde367b1ea44b1d114ad0e55ef932bc473f3900585cd611e989f64780e.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_ferry-1f907f64d317adc52f3e9abf613884b140ad38ae28f5153c99b2569b1a26a674.svg",
    "regular": "https://marinas.com/assets/map/marker_ferry-20bb3acde367b1ea44b1d114ad0e55ef932bc473f3900585cd611e989f64780e.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_ferry-67963604d93cc5547e29be8f56e66290ef12cb73a72ad38d7678ffb5e60ec928.svg"
  }
}
Landmark Retrieve

Returns the requested landmark

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/landmarks/wqsx
Response
{
  "id": "wqsx",
  "resource": "landmark",
  "name": "Damariscove Island, Eastern Tower",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 43.7542,
    "lon": -69.6125031,
    "what3words": "ribcage.stretches.dawn"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/landmark/wqsx_Damariscove_Island_Eastern_Tower_Landmark_Damariscotta_ME_United_States",
  "api_url": "https://api.marinas.com/v1/landmarks/wqsx",
  "icon_url": "https://marinas.com/assets/map/marker_landmark-ea7546c4fd3808495beb2dd71648bff53b27b53775184e82de28d6b4642bfea3.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_landmark-06372b51341fe6bbd1f5922361c5decca8278d994f800d734e13b8508e3a8410.svg",
    "regular": "https://marinas.com/assets/map/marker_landmark-ea7546c4fd3808495beb2dd71648bff53b27b53775184e82de28d6b4642bfea3.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_landmark-bc3efb1860dc523eda12bb06d34607754d53728f9ae9d9ebf68fd794ef53ed84.svg"
  }
}
Ramp Retrieve

Returns the requested ramp

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/ramps/wlc3
Response
{
  "id": "wlc3",
  "resource": "ramp",
  "name": "Anchorage Park Marina Ramp",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 26.8080997,
    "lon": -80.0710983,
    "what3words": "scarf.fencing.faces"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/ramp/wlc3_Anchorage_Park_Marina_Ramp_FL_United_States",
  "api_url": "https://api.marinas.com/v1/ramps/wlc3",
  "icon_url": "https://marinas.com/assets/map/marker_ramp-bf89640e772dbc6730ecabdef9383c853b655e6838285aeb2ddb9f651f92ffee.svg",
  "icon_urls": {
    "light": "https://marinas.com/assets/map/light/marker_ramp-cd016dd1a911bb98d5bb176fe543f006439ed4f9c08b401a6d32b9b025ff3d87.svg",
    "regular": "https://marinas.com/assets/map/marker_ramp-bf89640e772dbc6730ecabdef9383c853b655e6838285aeb2ddb9f651f92ffee.svg",
    "dark": "https://marinas.com/assets/map/dark/marker_ramp-d6f9fa2dcc5d6909b5688b688b2806b31205cbde47c5fd5aaea0376d7b614490.svg"
  }
}