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.2831666666389,
    "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 frommarina, 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 https://api.marinas.com/v1/points/search \
-d 'location[lat]=39.2831666666389' \
-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.2831666666389,
        "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.2831666666389,
      "lon": -76.3955
    },
    "sw": {
      "lat": 39.2831666666389,
      "lon": -76.3955
    }
  },
  "total_count": 892
}
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.2831666666389,
    "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 https://api.marinas.com/v1/marinas/search \
-d 'location[lat]=39.2888683118127' \
-d 'location[lon]=-76.3972025173826'
Response
{
  "resource": "geolist",
  "data": [
    {
      "id": "jncq",
      "resource": "marina",
      "name": "Baltimore Yacht Club",
      "rating": null,
      "review_count": 0,
      "location": {
        "lat": 39.2888683118127,
        "lon": -76.3972025173826,
        "what3words": "persuasive.rams.approve"
      },
      "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": 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.2888683118127,
      "lon": -76.3972025173826
    },
    "sw": {
      "lat": 39.2888683118127,
      "lon": -76.3972025173826
    }
  },
  "total_count": 70
}
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": null,
  "review_count": 0,
  "location": {
    "lat": 39.2888683118127,
    "lon": -76.3972025173826,
    "what3words": "persuasive.rams.approve"
  },
  "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": 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/ygtv
Response
{
  "id": "ygtv",
  "resource": "harbor",
  "name": "Bass Harbor",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 44.2546997,
    "lon": -68.3480988,
    "what3words": "shutter.unfilled.sugars"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/harbor/ygtv_Bass_Harbor_Tremont_ME_United_States",
  "api_url": "https://api.marinas.com/v1/harbors/ygtv",
  "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/zgfl
Response
{
  "id": "zgfl",
  "resource": "anchorage",
  "name": "Matinicus Island Moorings",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 43.8652992,
    "lon": -68.8824997,
    "what3words": "rooks.deductions.another"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/anchorage/zgfl_Matinicus_Island_Moorings_Anchorage_Matinicus_Island_ME_United_States",
  "api_url": "https://api.marinas.com/v1/anchorages/zgfl",
  "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/33h8
Response
{
  "id": "33h8",
  "resource": "lock",
  "name": "Holt Lock",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 33.2518997,
    "lon": -87.4511032,
    "what3words": "tattoos.soften.beware"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/lock/33h8_Holt_Lock_AL_United_States",
  "api_url": "https://api.marinas.com/v1/locks/33h8",
  "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/21b3
Response
{
  "id": "21b3",
  "resource": "ferry",
  "name": "Hammer Ferry Bridge",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 55.7552986,
    "lon": 11.8436003,
    "what3words": "carefully.renditions.shines"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/ferry/21b3_Hammer_Ferry_Bridge_Frederiksborg_Denmark",
  "api_url": "https://api.marinas.com/v1/ferrys/21b3",
  "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/rjs1
Response
{
  "id": "rjs1",
  "resource": "landmark",
  "name": "Fregatten Jyllands Ship",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 56.2000008,
    "lon": 10.6702995,
    "what3words": "unleash.costing.dunk"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/landmark/rjs1_Fregatten_Jyllands_Ship_Landmark_North_Jutland_Denmark",
  "api_url": "https://api.marinas.com/v1/landmarks/rjs1",
  "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/2zc9
Response
{
  "id": "2zc9",
  "resource": "ramp",
  "name": "Wellingdorf Boat Works",
  "rating": null,
  "review_count": 0,
  "location": {
    "lat": 54.3258018,
    "lon": 10.1856003,
    "what3words": "surfed.genetics.boxing"
  },
  "images": {
    "resource": "list",
    "data": [

    ],
    "total_count": 0
  },
  "web_url": "https://marinas.com/view/ramp/2zc9_Wellingdorf_Boat_Works_Ramp_Schleswig-Holstein_Germany",
  "api_url": "https://api.marinas.com/v1/ramps/2zc9",
  "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"
  }
}