{
  "info": {
    "_postman_id": "a7481bf5-25e0-49c1-9628-40f139a97a95",
    "name": "VesselFinder AIS Containers Distance API",
    "description": "REST API providing real-time and on-demand AIS vessel positions, voyage information,\nand vessel master data from the VesselFinder global AIS network (terrestrial and satellite).\nAuthentication is performed via the `userkey` query parameter. Responses default to JSON\nand may be requested as XML by setting `format=xml`. Most pay-per-use methods deduct credits\nfrom the account's balance; subscription methods (VesselsList, LiveData) are billed by fleet\nor area size and dataset selection.\n\n\nContact Support:\n Name: VesselFinder API Support",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:29:31.000Z",
    "updatedAt": "2026-07-28T03:29:31.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-a7481bf5-25e0-49c1-9628-40f139a97a95"
  },
  "item": [
    {
      "name": "distance",
      "item": [
        {
          "name": "Get Sea Distance",
          "id": "fff6f4cf-bc03-4737-aa6b-a9047905907b",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/distance?userkey=<string>&from=<string>&to=<string>&gateways=<string>&ECA=minimize&EPSG3857=0",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "distance"
              ],
              "query": [
                {
                  "description": "(Required) Personal API key issued by VesselFinder.",
                  "key": "userkey",
                  "value": "<string>"
                },
                {
                  "description": "(Required) Origin as `lon,lat`.",
                  "key": "from",
                  "value": "<string>"
                },
                {
                  "description": "(Required) Destination as `lon,lat`.",
                  "key": "to",
                  "value": "<string>"
                },
                {
                  "description": "Comma-separated list of allowed gateways (suez, panama, kiel, oresund, messina, corinth, malacca, drake, magellan, northeast, northwest).",
                  "key": "gateways",
                  "value": "<string>"
                },
                {
                  "description": "Emission Control Area preference.",
                  "key": "ECA",
                  "value": "minimize"
                },
                {
                  "description": "Set to 1 to return coordinates in WebMercator (EPSG:3857).",
                  "key": "EPSG3857",
                  "value": "0"
                }
              ]
            },
            "description": "Return the shortest sea route between two coordinates as a GeoJSON LineString together with distance in meters."
          },
          "response": [
            {
              "id": "27e80042-f842-4394-94cc-d7309b1c1849",
              "name": "GeoJSON Feature describing the computed route.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/distance?userkey=<API Key>&from=<string>&to=<string>&gateways=<string>&ECA=minimize&EPSG3857=0",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "distance"
                  ],
                  "query": [
                    {
                      "description": "(Required) Personal API key issued by VesselFinder.",
                      "key": "userkey",
                      "value": "<API Key>"
                    },
                    {
                      "description": "(Required) Origin as `lon,lat`.",
                      "key": "from",
                      "value": "<string>"
                    },
                    {
                      "description": "(Required) Destination as `lon,lat`.",
                      "key": "to",
                      "value": "<string>"
                    },
                    {
                      "description": "Comma-separated list of allowed gateways (suez, panama, kiel, oresund, messina, corinth, malacca, drake, magellan, northeast, northwest).",
                      "key": "gateways",
                      "value": "<string>"
                    },
                    {
                      "description": "Emission Control Area preference.",
                      "key": "ECA",
                      "value": "minimize"
                    },
                    {
                      "description": "Set to 1 to return coordinates in WebMercator (EPSG:3857).",
                      "key": "EPSG3857",
                      "value": "0"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"type\": \"<string>\",\n  \"properties\": {\n    \"Crossing\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"Distance\": \"<number>\",\n    \"DistanceECA\": \"<number>\"\n  },\n  \"geometry\": {\n    \"type\": \"<string>\",\n    \"coordinates\": [\n      [\n        \"<number>\",\n        \"<number>\"\n      ],\n      [\n        \"<number>\",\n        \"<number>\"\n      ]\n    ]\n  }\n}",
              "createdAt": "2026-07-28T03:29:31.000Z",
              "updatedAt": "2026-07-28T03:29:31.000Z",
              "uid": "35240-27e80042-f842-4394-94cc-d7309b1c1849"
            },
            {
              "id": "ee778bc6-1ced-49a0-9763-0256d820b463",
              "name": "Invalid or missing userkey.",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/distance?userkey=<API Key>&from=<string>&to=<string>&gateways=<string>&ECA=minimize&EPSG3857=0",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "distance"
                  ],
                  "query": [
                    {
                      "description": "(Required) Personal API key issued by VesselFinder.",
                      "key": "userkey",
                      "value": "<API Key>"
                    },
                    {
                      "description": "(Required) Origin as `lon,lat`.",
                      "key": "from",
                      "value": "<string>"
                    },
                    {
                      "description": "(Required) Destination as `lon,lat`.",
                      "key": "to",
                      "value": "<string>"
                    },
                    {
                      "description": "Comma-separated list of allowed gateways (suez, panama, kiel, oresund, messina, corinth, malacca, drake, magellan, northeast, northwest).",
                      "key": "gateways",
                      "value": "<string>"
                    },
                    {
                      "description": "Emission Control Area preference.",
                      "key": "ECA",
                      "value": "minimize"
                    },
                    {
                      "description": "Set to 1 to return coordinates in WebMercator (EPSG:3857).",
                      "key": "EPSG3857",
                      "value": "0"
                    }
                  ]
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "text",
              "header": [],
              "cookie": [],
              "responseTime": null,
              "body": null,
              "createdAt": "2026-07-28T03:29:31.000Z",
              "updatedAt": "2026-07-28T03:29:31.000Z",
              "uid": "35240-ee778bc6-1ced-49a0-9763-0256d820b463"
            },
            {
              "id": "d0e9d75a-82fb-4f7d-aae3-d9008817f843",
              "name": "Insufficient credits or expired access.",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/distance?userkey=<API Key>&from=<string>&to=<string>&gateways=<string>&ECA=minimize&EPSG3857=0",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "distance"
                  ],
                  "query": [
                    {
                      "description": "(Required) Personal API key issued by VesselFinder.",
                      "key": "userkey",
                      "value": "<API Key>"
                    },
                    {
                      "description": "(Required) Origin as `lon,lat`.",
                      "key": "from",
                      "value": "<string>"
                    },
                    {
                      "description": "(Required) Destination as `lon,lat`.",
                      "key": "to",
                      "value": "<string>"
                    },
                    {
                      "description": "Comma-separated list of allowed gateways (suez, panama, kiel, oresund, messina, corinth, malacca, drake, magellan, northeast, northwest).",
                      "key": "gateways",
                      "value": "<string>"
                    },
                    {
                      "description": "Emission Control Area preference.",
                      "key": "ECA",
                      "value": "minimize"
                    },
                    {
                      "description": "Set to 1 to return coordinates in WebMercator (EPSG:3857).",
                      "key": "EPSG3857",
                      "value": "0"
                    }
                  ]
                }
              },
              "status": "Payment Required",
              "code": 402,
              "_postman_previewlanguage": "text",
              "header": [],
              "cookie": [],
              "responseTime": null,
              "body": null,
              "createdAt": "2026-07-28T03:29:31.000Z",
              "updatedAt": "2026-07-28T03:29:31.000Z",
              "uid": "35240-d0e9d75a-82fb-4f7d-aae3-d9008817f843"
            }
          ],
          "createdAt": "2026-07-28T03:29:31.000Z",
          "updatedAt": "2026-07-28T03:29:31.000Z",
          "uid": "35240-fff6f4cf-bc03-4737-aa6b-a9047905907b"
        }
      ],
      "id": "6915d1b1-ff72-419e-a67d-7a940429e231",
      "createdAt": "2026-07-28T03:29:31.000Z",
      "updatedAt": "2026-07-28T03:29:31.000Z",
      "uid": "35240-6915d1b1-ff72-419e-a67d-7a940429e231"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "userkey",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "query",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.vesselfinder.com"
    }
  ]
}