DAdatalastic
Ports

Find ports by name, country, or UNLOCODE

Changed on

Search the ports database by name, UN/LOCODE, type, country, or geographic area. Fuzzy search finds ports by approximate name. Geographic search returns ports within a radius of a coordinate. A single request can return multiple matches, for example all ports in Italy.

Credit cost: 1 per port found, capped at 500 credits per request.

get/api/v0/port_find

Request

Query parameters

namestring

Full or partial port name.

country_isostring
unlocodestring
uuidstring uuid
fuzzy0 | 1

0 for exact name match (default), 1 for approximate match.

port_type'Port' | 'Anchorage' | 'Marina' | 'Offshore Terminal' | 'Shelter' | 'Demolition Yard' | 'Canal' | 'Fishing Harbour'

Filter by port classification.

latnumber float

Centre latitude. Use with lon and radius.

lonnumber float

Centre longitude. Use with lat and radius.

radiusnumber float

Search radius in nautical miles. Maximum 50.

Response

Matching ports.

Example response

{
  "data": [
    {
      "uuid": "37a8ac5b-d126-d7ce-9aca-7b8249c2efd2",
      "port_name": "ROTTERDAM",
      "country_iso": "NL",
      "country_name": "Netherlands",
      "unlocode": "NLRTM",
      "port_type": "Port",
      "lat": 51.94331,
      "lon": 4.141812,
      "area_lvl1": "UK Coast & Atlantic",
      "area_lvl2": "Rotterdam Area",
      "terminals": [
        {
          "terminal_code": "MPT",
          "terminal_name": "MARIN PORT TERMINAL",
          "company_name": "PEREZ TORRES MARITIMA S.L.",
          "lat": 42.405278,
          "lon": -8.692778,
          "url": "https://www.ptmar.com/en/puertos/puerto-marin",
          "address": "Muelle comercial s/n, 36900 Marin, Pontevedra, Spain"
        }
      ]
    }
  ],
  "meta": {
    "duration": 0.012,
    "endpoint": "/api/v0/vessel",
    "success": true,
    "next": "00e32b7a-4067-d6b2-8d73-2bdda4fe72bb"
  }
}

Changes

  • a29cf323d1c3Revision changes
    • breaking

      the query request parameter port_type was restricted to a list of enum values

    • warning

      deleted the query request parameter api-key

    • info

      added the new optional query request parameter lat

    • info

      added the new optional query request parameter lon

    • info

      added the new optional query request parameter radius

    • info

      added the new enum value Anchorage to the query request parameter port_type

    • info

      added the new enum value Canal to the query request parameter port_type

    • info

      added the new enum value Demolition Yard to the query request parameter port_type

    • info

      added the new enum value Fishing Harbour to the query request parameter port_type

    • info

      added the new enum value Marina to the query request parameter port_type

    • info

      added the new enum value Offshore Terminal to the query request parameter port_type

    • info

      added the new enum value Port to the query request parameter port_type

    • info

      added the new enum value Shelter to the query request parameter port_type

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

  • 0b2f634e7f91Revision changes
    • info

      added the new optional query request parameter fuzzy

    • info

      added the new optional query request parameter port_type