{ "info": { "_postman_id": "809763ed-490d-4938-b8bf-679f4ecd087f", "name": "VesselFinder AIS Containers List Manager 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:35.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "lastUpdatedBy": "35240", "uid": "35240-809763ed-490d-4938-b8bf-679f4ecd087f" }, "item": [ { "name": "listmanager", "item": [ { "name": "Get Watchlist", "id": "7ea4e569-ad9c-4471-92db-91b3abbb4eaf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] }, "description": "Return the current list of vessels (IMO and MMSI) backing the VesselsList method." }, "response": [ { "id": "fb0c0c99-812e-48fd-9e4b-0c879d5a4d79", "name": "Array of vessel identifiers in the watchlist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"imo\": [\n \"\",\n \"\"\n ],\n \"mmsi\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-fb0c0c99-812e-48fd-9e4b-0c879d5a4d79" }, { "id": "455c7c31-806e-4a1e-b41b-ba7ce1423d40", "name": "Invalid or missing userkey.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-455c7c31-806e-4a1e-b41b-ba7ce1423d40" } ], "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-7ea4e569-ad9c-4471-92db-91b3abbb4eaf" }, { "name": "Add Vessels To Watchlist", "id": "27e4ba3d-8b5a-4950-b92e-b0bf54477317", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] }, "description": "Add the supplied vessels (by IMO or MMSI) to the watchlist." }, "response": [ { "id": "4ad00ce6-415c-4a4e-a088-a010faa1e811", "name": "Watchlist updated.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-4ad00ce6-415c-4a4e-a088-a010faa1e811" }, { "id": "20cf703d-e97f-44f2-bdcb-4b1d389ead96", "name": "Invalid or missing userkey.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-20cf703d-e97f-44f2-bdcb-4b1d389ead96" } ], "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-27e4ba3d-8b5a-4950-b92e-b0bf54477317" }, { "name": "Replace Watchlist", "id": "92f829eb-805f-4312-b004-ea304c52fb2e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] }, "description": "Replace all vessels in the watchlist with the supplied list." }, "response": [ { "id": "edbe287d-6488-4d27-b871-c22aae4bcbc3", "name": "Watchlist replaced.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-edbe287d-6488-4d27-b871-c22aae4bcbc3" }, { "id": "31c34ce6-6afa-4e47-b368-aee8fec07b75", "name": "Invalid or missing userkey.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "body": { "mode": "urlencoded", "urlencoded": [ { "description": "Comma-separated IMO numbers.", "key": "imo", "value": "" }, { "description": "Comma-separated MMSI numbers.", "key": "mmsi", "value": "" } ] }, "url": { "raw": "{{baseUrl}}/listmanager?userkey=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-31c34ce6-6afa-4e47-b368-aee8fec07b75" } ], "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-92f829eb-805f-4312-b004-ea304c52fb2e" }, { "name": "Remove Vessels From Watchlist", "id": "19f143e1-a8cf-493b-afb1-de93ad317d69", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/listmanager?userkey=&imo=&mmsi=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" }, { "key": "imo", "value": "" }, { "key": "mmsi", "value": "" } ] }, "description": "Remove the supplied vessels from the watchlist." }, "response": [ { "id": "4da9dc23-40c9-4ee2-a180-2afe14956a88", "name": "Vessels removed.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/listmanager?userkey=&imo=&mmsi=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" }, { "key": "imo", "value": "" }, { "key": "mmsi", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-4da9dc23-40c9-4ee2-a180-2afe14956a88" }, { "id": "1f36c92e-0cb2-4f2e-ac70-2fc322536f8b", "name": "Invalid or missing userkey.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/listmanager?userkey=&imo=&mmsi=", "host": [ "{{baseUrl}}" ], "path": [ "listmanager" ], "query": [ { "description": "(Required) Personal API key issued by VesselFinder.", "key": "userkey", "value": "" }, { "key": "imo", "value": "" }, { "key": "mmsi", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-1f36c92e-0cb2-4f2e-ac70-2fc322536f8b" } ], "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-19f143e1-a8cf-493b-afb1-de93ad317d69" } ], "id": "a9389146-fe85-44ad-a1fb-c2f1e30d4427", "createdAt": "2026-07-28T03:29:36.000Z", "updatedAt": "2026-07-28T03:29:36.000Z", "uid": "35240-a9389146-fe85-44ad-a1fb-c2f1e30d4427" } ], "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" } ] }