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/eycq

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": "eycq",
  "resource": "point",
  "name": "All Star Marine",
  "kind": "marina",
  "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",
  "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
  },
  "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.283166666638884' \
-d 'location[lon]=-76.3955'
Response
{
  "resource": "geolist",
  "data": [
    {
      "id": "eycq",
      "resource": "point",
      "name": "All Star Marine",
      "kind": "marina",
      "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",
      "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
      },
      "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.283166666638884,
      "lon": -76.3955
    },
    "sw": {
      "lat": 39.283166666638884,
      "lon": -76.3955
    }
  },
  "total_count": 290
}
Point Retrieve

Returns the requested point

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/points/eycq
Response
{
  "id": "eycq",
  "resource": "point",
  "name": "All Star Marine",
  "kind": "marina",
  "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",
  "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
  },
  "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.28783449044417' \
-d 'location[lon]=-76.39857580839772'
Response
{
  "resource": "geolist",
  "data": [
    {
      "id": "jncq",
      "resource": "marina",
      "name": "Baltimore Yacht Club",
      "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",
      "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": 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
      }
    }
  ],
  "bounds": {
    "ne": {
      "lat": 39.28783449044417,
      "lon": -76.39857580839772
    },
    "sw": {
      "lat": 39.28783449044417,
      "lon": -76.39857580839772
    }
  },
  "total_count": 672
}
Marina Retrieve

Returns the requested marina

Arguments
id
class String
Request
curl -XGET https://api.marinas.com/v1/marinas/jncq
Response
{
  "id": "jncq",
  "resource": "marina",
  "name": "Baltimore Yacht Club",
  "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",
  "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": 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
  }
}
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/zjir
Response
{
  "id": "zjir",
  "resource": "inlet",
  "name": "Barnegat Inlet",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 39.7557983,
    "lon": -74.0924988,
    "what3words": "founder.slimmer.encourage"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/inlet/zjir_Barnegat_Inlet_Barnegat_Light_NJ_United_States",
  "api_url": "https://api.marinas.com/v1/inlets/zjir",
  "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/nyu3
Response
{
  "id": "nyu3",
  "resource": "bridge",
  "name": "E52 Frederikssund Bridge",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 55.8442001,
    "lon": 12.0417004,
    "what3words": "grunts.vitals.bartender"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/bridge/nyu3_E52_Frederikssund_Bridge_Frederiksberg_Denmark",
  "api_url": "https://api.marinas.com/v1/bridges/nyu3",
  "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/n2hw
Response
{
  "id": "n2hw",
  "resource": "lock",
  "name": "General Joe Wheeler Lock",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 34.8128014,
    "lon": -87.3843994,
    "what3words": "bookstores.abolish.exuding"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/lock/n2hw_General_Joe_Wheeler_Lock_AL_United_States",
  "api_url": "https://api.marinas.com/v1/locks/n2hw",
  "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/enae
Response
{
  "id": "enae",
  "resource": "lighthouse",
  "name": "Lynde Point Light",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 41.2714005,
    "lon": -72.3435974,
    "what3words": "prowess.docked.product"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/lighthouse/enae_Lynde_Point_Light_Lighthouse_CT_United_States",
  "api_url": "https://api.marinas.com/v1/lighthouses/enae",
  "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/wzbr
Response
{
  "id": "wzbr",
  "resource": "ferry",
  "name": "Hardeshøj Ferry Harbor",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 55.0066986,
    "lon": 9.6930599,
    "what3words": "neared.gulls.coveted"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/ferry/wzbr_Hardeshøj_Ferry_Harbor_South_Jutland_Denmark",
  "api_url": "https://api.marinas.com/v1/ferrys/wzbr",
  "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/2rse
Response
{
  "id": "2rse",
  "resource": "landmark",
  "name": "Maine Maritime Museum",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 43.8936005,
    "lon": -69.8135986,
    "what3words": "grumble.babysitter.scrolled"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/landmark/2rse_Maine_Maritime_Museum_Landmark_Bath_ME_United_States",
  "api_url": "https://api.marinas.com/v1/landmarks/2rse",
  "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"
  }
}